CustomResources > Schema

Reads a single Schema

Changed on

Reads a single Schema

get/api/2026-10-01/resources/custom_resources/schemas/{id}

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/custom_resources/schemas/{id}
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: custom_fields
    • or API key in header x-api-key

Path parameters

idstring required

Schemas identifiers

Response

OK

idstring required

Schema identifier

namestring required

Schema name

company_idstring required

Company identifier where this schema belongs

hiddenboolean required

Manages visibility of the schema

positioninteger

Schema position within employee profile

Example response

{
  "id": "1",
  "name": "Company Offsite",
  "company_id": "2",
  "position": 1
}

Changes