---
title: "Modify a credential"
method: POST
path: "/api/credentials/external/{extId}"
tags: ["credential-controller"]
---

# Modify a credential

`POST /api/credentials/external/{extId}`

Modify credential based on external ID.

## Path parameters

- `extId` string, required

## Query parameters

- `tokenValue` string

## Request body

- string, byte

## Response `200`

OK

- CredentialIssuanceResponse
  - `code` integer
  - `credentials` Credential[]
    - `cancelledDtm` TimestampRes
      - `date` integer
      - `day` integer
      - `hours` integer
      - `minutes` integer
      - `month` integer
      - `nanos` integer
      - `seconds` integer
      - `time` integer
      - `timezoneOffset` integer
      - `year` integer
    - `correlationId` string
    - `createdDtm` TimestampRes
      - `date` integer
      - `day` integer
      - `hours` integer
      - `minutes` integer
      - `month` integer
      - `nanos` integer
      - `seconds` integer
      - `time` integer
      - `timezoneOffset` integer
      - `year` integer
    - `credentialProviderId` string
    - `credentialProviderName` string
    - `credentialTypeId` string
    - `credentialTypeName` string
    - `extId` string
    - `href` string
    - `id` string
    - `issueStatus` string
    - `jwt` string
    - `permittedOperations` string[]
    - `revokedDtm` TimestampRes
      - `date` integer
      - `day` integer
      - `hours` integer
      - `minutes` integer
      - `month` integer
      - `nanos` integer
      - `seconds` integer
      - `time` integer
      - `timezoneOffset` integer
      - `year` integer
    - `statusCheckCount` integer
    - `usageRecord` UsageRecord
      - `checkpointPresentations` object
      - `checkpointTypePresentations` object
      - `presentations` integer
    - `usePolicy` CredentialUsePolicy
      - `checkpointPolicy` 'TIME_BASED' | 'VALIDATION_COUNT_BASED'
      - `checkpointTypePolicy` 'TIME_BASED' | 'VALIDATION_COUNT_BASED'
      - `numberOfCheckpointTypeValidations` integer
      - `numberOfCheckpointValidations` integer
      - `numberOfValidations` integer
      - `policy` 'TIME_BASED' | 'VALIDATION_COUNT_BASED'
  - `message` string

## Other responses

- `201` — Created
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Unexpected error in processing the request.

---

[API](https://skmtc.dev/myverifly/apis/api-documentation.md) · [All operations](https://skmtc.dev/myverifly/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/myverifly/api-documentation/revisions/03f300608c33/schema)