> ## Documentation Index > Fetch the complete documentation index at: https://docs.trybloom.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get a changed Brand file > Return a bounded page from the exact base and candidate file snapshots. Follow nextCursor until null to reconstruct both complete files. ## OpenAPI ````yaml https://www.trybloom.ai/api/v1/spec.json get /brands/{id}/edits/{editId}/files openapi: 3.1.1 info: title: Bloom API version: 1.0.0 servers: - url: https://www.trybloom.ai/api/v1 security: - apiKey: [] - bearer: [] tags: - name: Account description: >- Inspect the authenticated account — profile, credit balance, and accessible workspaces. - name: Brands description: Manage brands and brand identity. - name: Images description: Generate, edit, and retrieve images. - name: Uploads description: >- Stage private local files for Brand sources, Library images, and other supported operations. paths: /brands/{id}/edits/{editId}/files: get: tags: - Brands summary: Get a changed Brand file description: >- Return a bounded page from the exact base and candidate file snapshots. Follow nextCursor until null to reconstruct both complete files. operationId: brands.getEditFile parameters: - name: id in: path required: true schema: type: string format: uuid description: Brand ID - name: editId in: path required: true schema: type: string format: uuid description: Brand edit ID - name: path in: query required: true schema: type: string minLength: 1 maxLength: 512 description: Changed Markdown file path allowEmptyValue: true allowReserved: true - name: cursor in: query required: false schema: type: string maxLength: 128 description: Pagination cursor returned by the previous page allowEmptyValue: true allowReserved: true responses: '200': description: OK content: application/json: schema: type: object properties: data: type: object properties: schemaVersion: const: 2 editId: type: string format: uuid status: enum: - awaiting_approval - applied - discarded - stale type: string path: type: string minLength: 1 operation: enum: - add - remove - modify type: string base: anyOf: - type: object properties: skillId: type: string format: uuid fileSha256: type: string pattern: ^[a-f0-9]{64}$ startCharacter: type: integer minimum: 0 maximum: 9007199254740991 endCharacter: type: integer minimum: 0 maximum: 9007199254740991 totalCharacters: type: integer minimum: 0 maximum: 9007199254740991 content: type: string required: - skillId - fileSha256 - startCharacter - endCharacter - totalCharacters - content additionalProperties: false - type: 'null' candidate: anyOf: - type: object properties: skillId: type: string format: uuid fileSha256: type: string pattern: ^[a-f0-9]{64}$ startCharacter: type: integer minimum: 0 maximum: 9007199254740991 endCharacter: type: integer minimum: 0 maximum: 9007199254740991 totalCharacters: type: integer minimum: 0 maximum: 9007199254740991 content: type: string required: - skillId - fileSha256 - startCharacter - endCharacter - totalCharacters - content additionalProperties: false - type: 'null' hasMore: type: boolean nextCursor: anyOf: - type: string - type: 'null' required: - schemaVersion - editId - status - path - operation - base - candidate - hasMore - nextCursor additionalProperties: false required: - data '400': description: '400' content: application/json: schema: $ref: '#/components/schemas/BrandsGetEditFile400ErrorResponse' '401': description: '401' content: application/json: schema: $ref: '#/components/schemas/BrandsGetEditFile401ErrorResponse' '403': description: '403' content: application/json: schema: $ref: '#/components/schemas/BrandsGetEditFile403ErrorResponse' '404': description: '404' content: application/json: schema: $ref: '#/components/schemas/BrandsGetEditFile404ErrorResponse' '429': description: '429' content: application/json: schema: $ref: '#/components/schemas/BrandsGetEditFile429ErrorResponse' headers: Retry-After: description: >- Seconds until the API-key request limit resets. Present only when the request-rate limiter can calculate the delay. schema: type: integer minimum: 0 '500': description: '500' content: application/json: schema: $ref: '#/components/schemas/BrandsGetEditFile500ErrorResponse' components: schemas: BrandsGetEditFile400ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: INVALID_CURSOR status: const: 400 message: type: string default: Invalid pagination cursor data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error BrandsGetEditFile401ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: UNAUTHORIZED status: const: 401 message: type: string default: Invalid or missing API credentials data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error BrandsGetEditFile403ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: ACCOUNT_BANNED status: const: 403 message: type: string default: This account has been suspended. data: {} required: - code - status - message - type: object properties: code: const: FORBIDDEN status: const: 403 message: type: string default: Plan upgrade required data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error BrandsGetEditFile404ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: BRAND_NOT_FOUND status: const: 404 message: type: string default: Brand not found data: {} required: - code - status - message - type: object properties: code: const: BRAND_EDIT_NOT_FOUND status: const: 404 message: type: string default: Brand edit not found data: {} required: - code - status - message - type: object properties: code: const: BRAND_EDIT_FILE_NOT_FOUND status: const: 404 message: type: string default: Changed Brand file not found data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error BrandsGetEditFile429ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: TOO_MANY_REQUESTS status: const: 429 message: type: string default: Rate limit exceeded data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error BrandsGetEditFile500ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: INTERNAL_ERROR status: const: 500 message: type: string default: Brand edit request failed data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error ApiError: type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: 'Bloom API key, for example `x-api-key: bloom_sk_...`.' bearer: type: http scheme: bearer description: Bloom API key (`Bearer bloom_sk_...`) or Bloom OAuth access token. ````