Sign in
Files

Find orphaned files

Return files on a branch that are not present in the provided file ID list.

post/v2/project/files/orphaned

Headers

gt-api-version'2025-01-01.v0' | '2025-11-03.v1' | '2026-02-18.v1' | '2026-03-06.v1'

API contract version. Defaults to the oldest supported version.

API contract version. Defaults to the oldest supported version.

gt-project-idstring

Target project ID. Required when authenticating with an organization API key; ignored with project-scoped API keys (the project is resolved from the key).

Target project ID. Required when authenticating with an organization API key; ignored with project-scoped API keys (the project is resolved from the key).

Request body

branchIdstring required
fileIdsstring[]

Response

Files present on the branch but absent from the request

Changes

Changed in 1 of the 3 revisions of this API.116

  • 367cd605d090116See the full diff
    • ▲

      the branchId request property's minLength was increased from 0 to 1

      request-property-min-length-increased

    • ○

      the endpoint scheme security BearerAuth was added to the API

      api-security-added

    • ○

      added the media type text/html for the response with the status 400

      response-media-type-added

    • ○

      added the media type text/html for the response with the status 401

      response-media-type-added

    • ○

      added the media type text/html for the response with the status 403

      response-media-type-added

    • ○

      added the media type text/html for the response with the status 404

      response-media-type-added

    • ○

      added the non-success response with the status 413

      response-non-success-status-added

    • ○

      added the non-success response with the status 429

      response-non-success-status-added

    • ○

      added the non-success response with the status 500

      response-non-success-status-added

    • ○

      the response property error became required for the status 400

      response-property-became-required

    • ○

      the response property error became required for the status 401

      response-property-became-required

    • ○

      the response property error became required for the status 403

      response-property-became-required

    • ○

      the response property error became required for the status 404

      response-property-became-required

    • ○

      the response property orphanedFiles became required for the status 200

      response-property-became-required

    • ○

      the response property orphanedFiles/items/fileId became required for the status 200

      response-property-became-required

    • ○

      the response property orphanedFiles/items/fileName became required for the status 200

      response-property-became-required

    • ○

      the response property orphanedFiles/items/versionId became required for the status 200

      response-property-became-required

    This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog