Skip to content
Connect an agent

Organisations

Send the whole library again

Queues every library diagram for the destination; files that are current are not uploaded again.

POST/orgs/{org}/storage/{id}/sync

TL;DR

QuestionAnswer
What does it do?Send the whole library again.
What does it take?org, id in the path.
What does it return?Status 200 with a body of type StorageSync.
What can go wrong?401 not signed in; 403 not the owner or an admin (orgs.forbidden), the plan does not include it (plan.storage_not_included), or the origin may not make changes; 404 no such organisation or destination, or the caller is not a member; 409 the destination is not on (storage.not_on); 429 too many requests; 503 sending to your storage is not available on this server (storage.unavailable). Every failure uses the one error envelope.

What it does

Queues every library diagram for the destination; files that are current are not uploaded again.

Path parameters

FieldTypeRequiredDescription
orgstringyesThe organisation's id or its slug.
idstringyesThe destination.

Responses

StatusMeaningBody
200How many diagrams were queued.StorageSync
401Not signed in.ErrorResponse
403Not the owner or an admin (orgs.forbidden), the plan does not include it (plan.storage_not_included), or the origin may not make changes.ErrorResponse
404No such organisation or destination, or the caller is not a member.ErrorResponse
409The destination is not on (storage.not_on).ErrorResponse
429Too many requests.ErrorResponse
503Sending to your storage is not available on this server (storage.unavailable).ErrorResponse

Response body

A 200 answer has the type StorageSync.

FieldTypeRequiredDescription
queuedintegeryesDiagrams queued to be sent.

See also

DocWhy
API referenceEvery endpoint, and the error envelope
SchemasEvery request and response type
Tool referenceThe operations as callable tools