Errors - Rainbrand

Failed API requests return an error object. For example, requesting a brand that cannot be found returns HTTP 404:

{
  "error": {
    "code": "BRAND_NOT_FOUND",
    "status": 404,
    "message": "Brand not found"
  }
}

Use code to decide how your application responds. message explains the failure to a person, and optional data supplies details specific to the error. Each endpoint’s response panel lists its error codes and fields. For credit and billing failures, see Credits and limits.

Feature not available

The API returns 403 FEATURE_NOT_AVAILABLE when a feature isn’t enabled for your integration.

{
  "error": {
    "code": "FEATURE_NOT_AVAILABLE",
    "status": 403,
    "message": "Brand editing is not enabled for this integration.",
    "data": {
      "feature": "brand_edits",
      "requestId": "a2a334a7-2f7f-46b3-a43f-c8bdd6f72bd9"
    }
  }
}

Field	Meaning
`feature`	The feature that isn’t available. See the values below.
`sourceIndex`	Optional position in `sources`, starting at 0. Included when a particular source caused the error.
`requestId`	Optional identifier to include when contacting support.

Known feature values

These are the current identifiers. Availability depends on your integration.

Value	Feature
`brands`	Accessing brands.
`brand_creation`	Creating brands.
`brand_exports`	Exporting Brand Skills.
`brand_edits`	Editing brands.
`brand_library`	Adding Library assets.
`brand_fonts`	Uploading brand fonts.
`briefs`	Creating Briefs.
`reviews`	Creating Reviews.
`generations`	Generating content.
`image_transformations`	Transforming images.
`temporary_uploads`	Staging temporary uploads.
`model_catalog`	Listing models.
`image_search`	Searching for images.
`docs_search`	Searching documentation.
`agent_feedback`	Submitting feedback.
`account`	Reading account information.
`workspaces`	Listing teams.
`credits`	Reading credit information.
`media`	Accessing media.
`pdf_sources`	Processing PDF sources.
`instagram_sources`	Processing Instagram sources.
`brand_sources`	Processing a source type.
`brand_processing`	Processing a brand.

New values may be added. If a value is unfamiliar, show the error’s message.