AlayaCare Employee Cost Centres API
The Employee Cost Centres API from AlayaCare — 3 operation(s) for employee cost centres.
The Employee Cost Centres API from AlayaCare — 3 operation(s) for employee cost centres.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/alayacare-employee-cost-centres-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
version: 1.0.19-oas3
title: AlayaCare Accounting Employee Cost Centres API
description: '**AlayaCare IDs:**
The following terms are used to reference IDs that identify resources in AlayaCare:
- id
- visit_id
- premium_id
- visit_premium_id
- employee_id
- cost_centre_id
- client_id
**External IDs**
The following terms are used to reference IDs that identify resources systems external to AlayaCare:
- employee_external_id
- client_external_id
External IDs are required to be unique.
No other assumptions are made regarding their format they are treated as strings.
'
servers:
- url: https://example.alayacare.com/ext/api/v2/accounting
security:
- basic_auth: []
tags:
- name: Employee Cost Centres
paths:
/cost_centres/{cost_centre_id}/employees:
parameters:
- in: path
name: cost_centre_id
description: Cost centre ID
required: true
schema:
type: integer
minimum: 1
post:
tags:
- Employee Cost Centres
summary: Add a cost centre to an employee
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CostCentreEmployeeCreateSchema'
description: '`employee_id` and `employee_external_id` are mutually exclusive, specifying both is an invalid request.
'
required: true
responses:
'200':
description: Cost centre added to a employee
content:
application/json:
schema:
$ref: '#/components/schemas/CostCentreEmployeeResponse'
'400':
$ref: '#/components/responses/ErrorResponseCostCentreDisabled'
'401':
$ref: '#/components/responses/ErrorResponseAuthentication'
/cost_centres/{cost_centre_id}/employees/{employee_id}:
parameters:
- in: path
name: cost_centre_id
description: Cost centre ID
required: true
schema:
type: integer
minimum: 1
- in: path
name: employee_id
description: Employee ID
required: true
schema:
type: integer
minimum: 1
delete:
tags:
- Employee Cost Centres
summary: Delete a cost centre from an employee
responses:
'204':
description: Cost centre deleted from emplouyee
'400':
$ref: '#/components/responses/ErrorResponseEmployeeCostCentreNotFound'
'401':
$ref: '#/components/responses/ErrorResponseAuthentication'
/cost_centres/{cost_centre_id}/employees/by_id/{employee_external_id}:
parameters:
- in: path
name: cost_centre_id
description: Cost centre ID
required: true
schema:
type: integer
minimum: 1
- in: path
name: employee_external_id
description: Employee external ID
required: true
schema:
type: string
delete:
tags:
- Employee Cost Centres
summary: Delete a cost centre from an employee using external ID
responses:
'204':
description: Cost centre deleted from emplouyee
'400':
$ref: '#/components/responses/ErrorResponseEmployeeCostCentreNotFound'
'401':
$ref: '#/components/responses/ErrorResponseAuthentication'
components:
schemas:
ErrorResponse:
description: Error response
type: object
properties:
code:
type: integer
example: 400
description: Response code
message:
type: string
example: Invalid request
description: Detailed error message
required:
- code
- message
CostCentreEmployeeCreateSchema:
type: object
properties:
employee_id:
type: integer
description: Employee ID
example: 1010
minimum: 1
employee_external_id:
type: string
description: Employee external ID
example: john.1010
CostCentreEmployeeResponse:
description: Employee to cost centre link
type: object
properties:
employee_id:
type: integer
description: Employee ID
example: 1010
minimum: 1
cost_centre_id:
type: integer
description: Cost centre ID
example: 10
minimum: 1
responses:
ErrorResponseEmployeeCostCentreNotFound:
description: The employee with the referenced cost_centre_id was not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
response:
value:
code: '400'
message: Employee with ID 1010 and Cost Centre ID 10 not found
ErrorResponseAuthentication:
description: Authorization required
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
response:
value:
code: '401'
message: Authorization required.
ErrorResponseCostCentreDisabled:
description: The cost centre referenced by cost_centre_id is disabled
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
response:
value:
code: '400'
message: Cost centre is disabled
securitySchemes:
basic_auth:
type: http
description: Basic HTTP auth over https
scheme: basic