Ingest

Manually trigger a library's repository sync.

Queues an immediate sync of the private repository mapped to this library, outside its normal schedule. Requires the library to be configured with a private repository source (sourceKind/sourceRepoUrl set).

Returns 404 when the library doesn't exist, 400 when the library has no linked repository, 409 when a sync is already queued or running for this library, and 429 when more than 5 manual triggers have been requested in the last hour.

post/api/v1/orgs/{orgId}/libraries/{name}/ingest-run

Request

  • The document declares no server URL.
  • Auth: none declared

Path parameters

orgIdstring required
namestring required

Response

OK

runIdstring required

The id the eventual DocsIngestRun record will use. No row exists with this id yet — the queued sync message carries it forward so the consumer creates the row with this exact id once it processes the job.

runCreatedAtUtcstring date-time required

Partition key paired with RunId.

viewTokenstring required

Compact token encoding RunCreatedAtUtc and source kind, for a future run-status viewer endpoint.

Changes

No recorded changes to this operation across all 32 revisions of this API.