> ## Documentation Index
> Fetch the complete documentation index at: https://partners.trybloom.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a Brand Skill

> Return the current creation status. A completed Brand Skill includes a signed ZIP download URL valid for seven days. Poll until completed or failed.



## OpenAPI

````yaml /openapi/brand-skills.json get /brand-skills/{id}
openapi: 3.1.1
info:
  title: Bloom Brand Skills API
  version: 1.0.0
  description: Approved partner beta API for creating portable Brand Skills.
servers:
  - url: https://www.trybloom.ai/api/v1
security:
  - apiKey: []
  - bearer: []
tags:
  - name: Brand Skills
    description: Create, retrieve, download, and delete Brand Skills.
paths:
  /brand-skills/{id}:
    get:
      tags:
        - Brand Skills
      summary: Get a Brand Skill
      description: >-
        Return the current creation status. A completed Brand Skill includes a
        signed ZIP download URL valid for seven days. Poll until completed or
        failed.
      operationId: brandSkills.get
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            description: Brand Skill ID
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                      status:
                        enum:
                          - pending
                          - processing
                          - completed
                          - failed
                          - deleting
                        description: >-
                          Lifecycle state: pending is queued, processing is
                          being built, completed has a download, failed has
                          failure details, and deleting is being removed
                      brandName:
                        type: string
                        description: Brand Skill name
                      sources:
                        type: array
                        minItems: 1
                        maxItems: 2
                        items:
                          anyOf:
                            - type: object
                              properties:
                                kind:
                                  const: website
                                url:
                                  type: string
                                  format: uri
                              required:
                                - kind
                                - url
                            - type: object
                              properties:
                                kind:
                                  const: pdf
                                filename:
                                  type: string
                              required:
                                - kind
                                - filename
                        description: >-
                          Sources used to build the Brand Skill, in request
                          order. PDF input URLs are never returned
                      failure:
                        anyOf:
                          - type: object
                            properties:
                              code:
                                type: string
                                description: Machine-readable build failure code
                              message:
                                type: string
                                description: Human-readable failure message
                            required:
                              - code
                              - message
                          - type: 'null'
                        description: Failure details when status is failed; otherwise null
                      download:
                        anyOf:
                          - type: object
                            properties:
                              url:
                                type: string
                                format: uri
                                description: Temporary signed URL for the ZIP
                              filename:
                                type: string
                                description: Suggested ZIP filename
                              byteLength:
                                type: integer
                                minimum: 0
                                maximum: 9007199254740991
                                description: ZIP size in bytes
                            required:
                              - url
                              - filename
                              - byteLength
                          - type: 'null'
                        description: >-
                          Download details when status is completed; otherwise
                          null
                      createdAt:
                        type: string
                        format: date-time
                        x-native-type: date
                        description: Time the Brand Skill was created
                      completedAt:
                        anyOf:
                          - type: string
                            format: date-time
                            x-native-type: date
                          - type: 'null'
                        description: >-
                          Time the Brand Skill completed successfully; otherwise
                          null
                    required:
                      - id
                      - status
                      - brandName
                      - sources
                      - failure
                      - download
                      - createdAt
                      - completedAt
                required:
                  - data
        '401':
          description: '401'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: UNAUTHORIZED
                      status:
                        const: 401
                      message:
                        type: string
                        default: Invalid or missing API credentials
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
        '403':
          description: '403'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: ACCOUNT_BANNED
                      status:
                        const: 403
                      message:
                        type: string
                        default: This account has been suspended.
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: FORBIDDEN
                      status:
                        const: 403
                      message:
                        type: string
                        default: Plan upgrade required
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
        '404':
          description: '404'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: BRAND_SKILL_NOT_FOUND
                      status:
                        const: 404
                      message:
                        type: string
                        default: Brand Skill not found
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
        '429':
          description: '429'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: TOO_MANY_REQUESTS
                      status:
                        const: 429
                      message:
                        type: string
                        default: Rate limit exceeded
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
        '500':
          description: '500'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: INTERNAL_ERROR
                      status:
                        const: 500
                      message:
                        type: string
                        default: Failed to retrieve Brand Skill
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
components:
  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.

````