API · v1 · stabil
CODEMETA OSDeveloper Center
Konsole öffnen
Entity · delegations

Delegation Schema

Schema-ID
delegation
Collection
delegations
Permissions
  • Lesendelegation_view
  • Anlegendelegation_create_self
  • Änderndelegation_edit_self
  • Löschendelegation_delete_self

Felder

Delegation Schema

delegations4 Permissions

Time-bounded stand-in arrangement for workflow addressing (ADR 0108)

delegatorUserIduuiderforderlich

User who is being delegated FROM (the absentee).

delegateToUserIduuiderforderlich

User who STANDS IN — receives the workflow steps in the delegator's place.

scopeobjecterforderlich

What the delegation covers. ALL = every approval + workflow address; APPROVALS = filtered by approvalTypes; POSITION = the delegator's tenure on a specific position only.

kindstringerforderlich
Werte
ALLAPPROVALSPOSITION
approvalTypesstring[]optional

For kind=APPROVALS: optional whitelist (e.g. ["vacation_request", "expense_report"]). Empty/missing = all approval types.

max 50 Itemsnullable
positionIduuidoptional

For kind=POSITION: the position whose addressing is delegated.

nullable
validFromdateerforderlich

First effective day (inclusive).

validTodateoptional

Last effective day (inclusive). Null = open-ended (rare; usually a vacation has a return date).

nullable
reasonstringoptional

Optional categorisation for HR reports.

Werte
VACATIONSICK_LEAVEBUSINESS_TRIPOTHER
nullable
cascadeIfDelegateAbsentbooleanoptional

When true and the delegate is themselves on delegation during the requested point, the resolver tries the delegate's delegate (one extra hop). When false, an absent delegate just fails-through to the original delegator (caller decides next step).

Default: false
notestringoptional

Free-text note shown in the delegation centre.

max 500 Zeichennullable
sourceVacationRequestIduuidoptional

Backlink to the vacation_request that auto-created this delegation. Set by the vacation-approval workflow; soft-delete cascades when the vacation_request is cancelled. Manual delegations leave this null.

read-onlynullable

Standard-Endpoints

Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:

  • GET /api/v1/delegations — Liste, paginiert + filterbar
  • GET /api/v1/delegations/<id> — Einzelne Entity
  • POST /api/v1/delegations — Anlegen
  • PATCH /api/v1/delegations/<id> — Teil-Update
  • DELETE /api/v1/delegations/<id> — Soft-Delete
  • GET /api/v1/delegations/<id>/timeline — Audit + Aktivitäten

Suche