Niucore

API reference

Areas

The unit over which libraries, skills and connectors are distributed.

List areas

GETapi.niucore.com/api/v1/areas

Scope: areas:read

Areas visible to the credential. They are the unit over which libraries, skills and connectors are distributed.

Note

Areas are read-only in v1.0: creating or editing them is organization administration, not automation.

Query

pageintegerdefaults to 1

Page number, starting at 1.

sizeintegerdefaults to 50

Items per page. Maximum 200.

curl -sS -X GET 'https://api.niucore.com/api/v1/areas' \
  -H "Authorization: Bearer $NIUCORE_ACCESS_TOKEN"
Response
{
  "status": "success",
  "message": "Operación exitosa",
  "message_code": "api_v1_ok",
  "data": [
    {
      "id": 4,
      "name": "Soporte",
      "description": "Atención al cliente y postventa.",
      "created_at": "2026-02-04T16:20:00Z"
    }
  ],
  "meta": {
    "request_id": "9f1c0a3e-7b2d-4f18-9a55-2c6e0d1b4a77",
    "page": 1,
    "size": 50,
    "total": 1
  }
}

Retrieve an area

GETapi.niucore.com/api/v1/areas/{area_id}

Scope: areas:read

Detail of one area.

Path

area_idintegerrequired

Identifier.

Errors

  • 404api_v1_not_foundIt does not exist, or it is outside the credential's scope. Both cases answer the same: a 403 would confirm the resource exists.
curl -sS -X GET 'https://api.niucore.com/api/v1/areas/4' \
  -H "Authorization: Bearer $NIUCORE_ACCESS_TOKEN"
Response
{
  "status": "success",
  "message": "Operación exitosa",
  "message_code": "api_v1_ok",
  "data": {
    "id": 4,
    "name": "Soporte",
    "description": "Atención al cliente y postventa.",
    "created_at": "2026-02-04T16:20:00Z"
  },
  "meta": {
    "request_id": "9f1c0a3e-7b2d-4f18-9a55-2c6e0d1b4a77"
  }
}