API referenceLicenses
Update license
Partially update a license by its ID
PATCH
/licenses/{id}curl -X PATCH "https://api.corma.io/v1/licenses/-9007199254740991" \
-H "x-corma-api-key: $CORMA_OPEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"licenseTypeKeys": [
"string"
],
"licenseRoleKeys": [
"string"
],
"billingStatus": "live",
"grantedAt": "2026-01-15T09:30:00Z",
"grantedById": "string"
}'Autorisation
x-corma-api-keystringheaderobligatoireColon-separated API key ID and secret:
API_KEY_ID:API_KEY_SECRET
Paramètres
idintegerpathobligatoirex-corma-idempotency-keystringheaderOptional client-generated key. Reusing the same key with an identical request replays the original response instead of enqueueing a duplicate task.
Corps
application/json
licenseTypeKeysstring[]licenseRoleKeysstring[]billingStatusenum<string> | nullUne des valeurs:liverevokedgrantedAtany of | nullgrantedByIdstring | null
Réponse
application/json200
OK
idnumberobligatoireapplicationInstanceIdintegerobligatoireuserUserEmbed | nullobligatoiregrantedByIdstring | nullobligatoiregrantedByUserEmbed | nullobligatoiregrantedAtstring<date-time> | nullobligatoirebillingStatusenum<string> | nullobligatoireUne des valeurs:liverevokedactivityStatusenum<string> | nullobligatoireUne des valeurs:activeinactiveappInternalIdstring | nullobligatoiresourcesActivitySource[]obligatoireconnectorIdstring | nullobligatoireThe connector this licence belongs to, as
GET /connectorsreturns its identifier. Null when no connector holds it.licenseTypesKeysstring[]obligatoirelicenseRolesKeysstring[]obligatoirecreatedAtstring<date-time>obligatoireThe timestamp of when this resource was created. ISO 8601 format.
updatedAtstring<date-time>obligatoireThe timestamp of the last update to this resource. ISO 8601 format.
{
"id": 0,
"applicationInstanceId": -9007199254740991,
"user": {
"id": "string",
"type": "employee",
"email": "string",
"personalEmail": "string",
"name": "string",
"idpStatus": "active",
"hrStatus": "active",
"jobKey": "string",
"countryCode": "string",
"departmentKey": "string",
"startDate": "2026-01-15T09:30:00Z",
"terminationDate": "2026-01-15T09:30:00Z"
},
"grantedById": "string",
"grantedBy": {
"id": "string",
"type": "employee",
"email": "string",
"personalEmail": "string",
"name": "string",
"idpStatus": "active",
"hrStatus": "active",
"jobKey": "string",
"countryCode": "string",
"departmentKey": "string",
"startDate": "2026-01-15T09:30:00Z",
"terminationDate": "2026-01-15T09:30:00Z"
},
"grantedAt": "2026-01-15T09:30:00Z",
"billingStatus": "live",
"activityStatus": "active",
"appInternalId": "string",
"sources": [
{
"type": "integration_sync_unit",
"kind": "google",
"method": "api",
"syncUnitId": "string",
"label": "string",
"author": "string",
"isOriginating": true,
"firstActivityAt": "2026-01-15T09:30:00Z",
"lastActivityAt": "2026-01-15T09:30:00Z"
}
],
"connectorId": "string",
"licenseTypesKeys": [
"string"
],
"licenseRolesKeys": [
"string"
],
"createdAt": "2026-01-15T09:30:00Z",
"updatedAt": "2026-01-15T09:30:00Z"
}