Ressurs

Activity

Oppgaver og avtaler på et prosjekt — postene bak «Aktiviteter»-skjermen i origo. Full CRUD; sletting lukker aktiviteten som standard og kan i stedet fjerne den permanent.

En aktivitet er én arbeidsenhet på et prosjekt: et navn og en fritekstbeskrivelse, en ansvarlig person, en status, en frist, timeanslag og klassifiseringene for type, prioritet, alvorlighet og løsning som prosjektets mal tilbyr. Hver aktivitet hører til nøyaktig ett prosjekt — projectId er påkrevd både når du oppretter en aktivitet og når du erstatter den. Legg merke til hva strukturen ikke inneholder: det finnes ingen start- eller sluttid, og ingen felt for tid som faktisk er brukt. estimate og etc (estimate to complete) er anslag framover, og dueDate er en ren lokal dato, så en aktivitet er selve oppgave- eller avtaleposten og ikke en timeføring.

Status kan ikke skrives gjennom noe endepunkt på denne siden: en ny aktivitet starter på prosjektets standardstatus, og verken en full erstatning eller en merge-patch kan flytte den.

Endepunktreferansen under står på engelsk i begge språktrærne. Den gjengir API-kontrakten ordrett, og det finnes ingen generator å bygge den på nytt fra, så en oversatt kopi ville drevet fra API-et første gang et endepunkt endres.

Endepunkter

Åtte endepunkter, i samme rekkefølge som de er dokumentert nedenfor.

• POST /activity — Create an activity
• GET /activity/{activityId} — Get an activity
• GET /activity — List activities
• GET /activity/cursor — List activities by cursor
• GET /activity/timeline — List activities by change time
• PUT /activity/{activityId} — Replace an activity
• PATCH /activity/{activityId} — Partially update an activity
• DELETE /activity/{activityId} — Close or delete an activity

Alle endepunktene på denne siden kan i tillegg svare med fellesfeilene — 401, 403, 404 (ukjent instans) og 500. De er dokumentert én gang, under Feil og feilsøking.

curl -X POST "https://api.visena.example/acme/api/v1/en/activity" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Kickoff meeting",
    "projectId": "pJ7wN2",
    "dueDate": "2026-09-15"
  }'

curl "https://api.visena.example/acme/api/v1/en/activity/aT4cV9" \
  -H "Authorization: Bearer $TOKEN"

curl "https://api.visena.example/acme/api/v1/en/activity?projectId=pJ7wN2&offset=0&limit=20" \
  -H "Authorization: Bearer $TOKEN"

curl "https://api.visena.example/acme/api/v1/en/activity/cursor?limit=100" \
  -H "Authorization: Bearer $TOKEN"

Før du bygger en synkronisering på cursor- eller timeline-modusen, les synkroniseringssemantikken deres: hvilken av de to som gir ett konsistent uttrekk som må gås gjennom i én omgang, hvilken du gjenopptar fra, hvorfor levering er minst-én-gang slik at du må fjerne duplikater på id, og hva ingen av dem sier om rader som forsvinner. Alt dette er dokumentert én gang, for alle ressurser, under Lister, paginering og synk.

curl "https://api.visena.example/acme/api/v1/en/activity/timeline?since=2026-08-20T02:00:00Z" \
  -H "Authorization: Bearer $TOKEN"

curl -X PUT "https://api.visena.example/acme/api/v1/en/activity/aT4cV9" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Kickoff meeting",
    "projectId": "pJ7wN2",
    "dueDate": "2026-09-22"
  }'

curl -X PATCH "https://api.visena.example/acme/api/v1/en/activity/aT4cV9" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{
    "dueDate": "2026-09-22",
    "responsiblePersonId": "xK9mQ2"
  }'

curl -X DELETE "https://api.visena.example/acme/api/v1/en/activity/aT4cV9?mode=close" \
  -H "Authorization: Bearer $TOKEN"

Objektstrukturer

Forespørsels- og svarkroppene som brukes over, i den rekkefølgen de først refereres.

ActivityCreateDto

ActivityResponseDto

ActivityRefDto

Priority.

ActivityOffsetListResponse

ActivityListItemDto

The activities on this page, always in ascending order.

CompanyRefDto

The company the owning project belongs to, if any.

OrgNumberDto

Active organizational (registration) numbers; at most one per company.

CountryRefDto

Country this organizational number is registered in.

ActivityListLinks

Navigation links for this page.

ActivityCursorListResponse

ActivityUpdateDto