Update external sharing

PATCH

https://api.sureshake.com/v2/entities/{entityId}/collections/{id}/external-sharing

Path parameters

entityId
string
required
format: uuid

id
string
required
format: uuid

Request body JSON required

enabled
boolean
required
confirmed
true
required
reason
optional
string
maxLength: 500 · minLength: 1

Returns

200

Default Response

JSON

data
object
required
- collectionId
  string
  required
  format: uuid
- enabled
  boolean
  required
- changed
  boolean
  required
- effect
  external_access_enabled
  or
  external_access_suspended_tokens_not_revoked
  or
  unchanged
  required
- updatedAt
  string
  required
  format: date-time
}
meta
optional
object
- timestamp
  string
  required
  format: date-time
}

400

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

401

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

403

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

404

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

409

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

500

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

curl --request PATCH \ --url 'https://api.sureshake.com/v2/entities/<entityId>/collections/<id>/external-sharing' \ --header 'Content-Type: application/json' \ --data ' { "enabled": true, "confirmed": true, "reason": "string" } '