List categories
listCategoriesPermission read
The «Categorías» an OC takes its garment from: the plant’s own, for «Otros clientes», and those of each brand it works for in the «Red de talleres».
/v1/external/organizations/{organizationId}/categoriesAnswers the «Categorías de prenda» of «Configuración»: the kinds of garment (blusa, pantalón…) a «referencia» (an OC) is, which production figures are added up by.
own is the plant’s own list, plain names, for the OCs of its own clients («Otros clientes»). brands holds one group per brand («cuenta de marca») the plant works for in the «Red de talleres»: its companyAdminId, its name and its numbered catalogue (code «01», short «Blusa», name «Blusa · Vestido»). Both are empty for a plant that keeps no list and works for no brand.
Feed it to the «Programa»: the garment of createReference and updateReference takes one name of own, and a «referencia» read back (getProgram, getReference) carries the same string.
No id beyond organizationId; no time field; the read creates nothing.
Not paged: the whole answer comes in one response.
Plan: on every plan, Light included. A «token de API» reads it in any organization the user who created it belongs to; a connected AI app (a «conexión») reads it only where the organization has «Conectar con IA» (getPlan.features.aiConnector, a Pro feature), and answers 403 PLAN_LIMIT elsewhere.
Rate limit: one request of the credential’s ordinary budget in this organization (getPlan answers the numbers); past it, 429 RATE_LIMITED with Retry-After in seconds.
Authorization
apiToken An API token created in Configuración › Tokens de API, or a connected app’s access token
In: header
Path Parameters
The organization, from getMe or listOrganizations.
Response Body
application/json
application/json
curl -X GET "https://api.fluenta.io/v1/external/organizations/0/categories" \ -H "Authorization: Bearer fluenta_live_XXXX"{ "own": [ "string" ], "brands": [ { "companyAdminId": 0, "name": "string", "categories": [ { "code": "01", "short": "Blusa", "name": "Blusa · Vestido", "emoji": "string" } ] } ]}