Unit import reference

Unit import endpoint authentication, parameters, request and response contracts.

Last updated: 10 November 2026

On this page

POST /api/p/{pid}/birim-aktarim POST /api/p/{pid}/birim-aktarim/{token}/onizleme POST /api/p/{pid}/birim-aktarim/{token}DELETE /api/p/{pid}/birim-aktarim/{token}

Paths, methods, parameters and available schemas are generated from the OpenAPI document in the repository.

Note: These endpoints form the browser application contract and do not provide the same versioning assurance as v1. Use the versioned API for external integrations.

POST `/api/p/{pid}/birim-aktarim`

Upload unit records

Reads the table and returns its columns without writing persistent records. The original file is kept only in temporary processing storage.

Authentication: User session (cookie). Scope: Relevant organisation/project membership and operation permission; writes also check the current role, module and licence permissions.

Parameters

Name	Location	Type	Required
`pid`	path	integer	Yes

Request body

multipart/form-data

Field	Type	Required	Description
`file`	string	Yes

Responses

HTTP 200

application/json

This OpenAPI document does not define a body schema. See the relevant developer guide for details.

HTTP 422

application/json

Field	Type	Required	Description
`detail`	ValidationError[]	No

For error meanings and client actions, see the error code glossary.

POST `/api/p/{pid}/birim-aktarim/{token}/onizleme`

Preview unit import

Preview: records to import, existing records, records changed in the source, rejected records and columns that will not be retained. Writes no persistent records.

Authentication: User session (cookie). Scope: Relevant organisation/project membership and operation permission; writes also check the current role, module and licence permissions.

Parameters

Name	Location	Type	Required
`pid`	path	integer	Yes
`token`	path	string	Yes

Request body

application/json

Field	Type	Required
`kaynak`	string	Yes
`sayfa`	string \| null	No
`alanlar`	object	No
`sabitler`	object	No
`durumlar`	object	No

Responses

HTTP 200

application/json

This OpenAPI document does not define a body schema. See the relevant developer guide for details.

HTTP 422

application/json

Field	Type	Required	Description
`detail`	ValidationError[]	No

For error meanings and client actions, see the error code glossary.

POST `/api/p/{pid}/birim-aktarim/{token}`

Commit unit import

Import: recalculates the preview under a lock. If the displayed summary has changed, returns 409 and a new preview without writing. Runs in one transaction.

Authentication: User session (cookie). Scope: Relevant organisation/project membership and operation permission; writes also check the current role, module and licence permissions.

Parameters

Name	Location	Type	Required
`pid`	path	integer	Yes
`token`	path	string	Yes

Request body

application/json

Field	Type	Required
`kaynak`	string	Yes
`sayfa`	string \| null	No
`alanlar`	object	No
`sabitler`	object	No
`durumlar`	object	No
`request_id`	string	Yes
`ozet`	string	Yes

Responses

HTTP 200

application/json

This OpenAPI document does not define a body schema. See the relevant developer guide for details.

HTTP 422

application/json

Field	Type	Required	Description
`detail`	ValidationError[]	No

For error meanings and client actions, see the error code glossary.

DELETE `/api/p/{pid}/birim-aktarim/{token}`

Cancel unit import

Cancellation deletes the temporary file immediately.

Authentication: User session (cookie). Scope: Relevant organisation/project membership and operation permission; writes also check the current role, module and licence permissions.

Parameters

Name	Location	Type	Required
`pid`	path	integer	Yes
`token`	path	string	Yes

Responses

HTTP 200

application/json

This OpenAPI document does not define a body schema. See the relevant developer guide for details.

HTTP 422

application/json

Field	Type	Required	Description
`detail`	ValidationError[]	No

For error meanings and client actions, see the error code glossary.