---
title: "Replace card verifiers"
method: POST
path: "/api/v1/cards/{cardId}/verifiers"
tags: ["Card Verifiers"]
---

# Replace card verifiers

`POST /api/v1/cards/{cardId}/verifiers`

Create a card verifier and delete all existing verifiers

## Path parameters

- `cardId` string, required

## Request body

- CardVerifier[]
  - union
    - UserGroupVerifier
      - `id` string — ID of the verifier
      - `dateCreated` string, date-time — Date the verifier was created. Dates are in ISO-8601 format. Example date (January 2nd 2014 12pm UTC): 2014-01-02T12:00:00.000+0000
      - `type` 'user-group', required
      - `userGroup` UserGroup
        - `name` string — Group Name
        - `id` string — ID of the group
        - `members` UserGroupMember[]
          - `id` string — ID of the group member
          - `managedByScim` boolean
          - `dateCreated` string, date-time — Date the group member was added to the group. Dates are in ISO-8601 format. Example date (January 2nd 2014 12pm UTC): 2014-01-02T12:00:00.000+0000
          - `user` User, required
            - `id` string — The identifier of this User
            - `profilePicUrl` string — The profile picture url for the user
            - `joinedDate` string, date-time
            - `userProfile` UserProfile — Specifies additional information about a Guru User
              - …
            - `lastName` string, required — The user's last name
            - `firstName` string, required — The user's first name
            - `status` 'ACTIVE' | 'PENDING' — The status of a User can be ACTIVE or PENDING. The User must verify their email address to be considered ACTIVE.
            - `email` string, required — The user's email address
        - `expertIdRank` integer
        - `numberOfCardsAsVerifier` integer
        - `managedByScim` boolean
        - `groupIdentifier` string
        - `numberOfMembers` integer
        - `modifiable` boolean
        - `userModifiable` boolean
        - `singleUser` boolean
        - `team` Team
          - `name` string — Team Name
          - `id` string — ID of the fact
          - `profilePicUrl` string
          - `companyName` string — Team Company Name
          - `currentUserIsMember` boolean
          - `domain` string — Domain
          - `edition` TeamEdition
            - `adminOverrides` object
            - `name` string
            - `key` string
            - `id` string
            - `usage` object
            - `code` string
            - `features` object
          - `billableUsers` integer
          - `totalUsers` integer
          - `teamDomains` TeamDomain[]
            - `verificationCode` string
            - `verified` boolean
            - `capture` boolean
            - `domain` string
          - `slackCommandState` string
          - `slackCommandInstalled` boolean
          - `sfdcIntegrationState` string
          - `sfdcIntegrationInstalled` boolean
          - `clearProfilePic` boolean
          - `defaultGroup` UserGroup — recursive
          - `defaultUserType` 'FREE_CORE' | 'CORE'
          - `trialExpirationDate` string, date-time
          - `zendeskAssistState` string
          - `zendeskAssistInstalled` boolean
          - `zendeskKnowledgeState` string
          - `zendeskKnowledgeInstalled` boolean
          - `fileSharingDisabled` boolean
          - `collectionCreated` boolean
          - `teamCreationToken` string
          - `cardsCreated` integer
          - `topLevelOrganizationId` string
          - `numberOfCollections` integer
          - `numberOfOrgSharedCollections` integer
          - `allMembersGroupId` string
          - `deleted` boolean — Indicates if the fact has been deleted
          - `dateCreated` string, date-time — Date the team was created. Dates are in ISO-8601 format. Example date (January 2nd 2014 12pm UTC): 2014-01-02T12:00:00.000+0000
          - `userRole` string
          - `useCase` string
          - `description` string
          - `status` 'ACTIVE' | 'DORMANT' | 'LOCKED' | 'EXPIRED' | 'LOCKED_PAY'
          - `organization` Organization
            - `name` string
            - `id` string
            - `workspaces` Team[]
        - `dateCreated` string, date-time — Date the group was created. Dates are in ISO-8601 format. Example date (January 2nd 2014 12pm UTC): 2014-01-02T12:00:00.000+0000
        - `role` 'ADMIN' | 'AUTHOR' | 'MEMBER' | 'COLL_ADMIN'
    - UserVerifier
      - `id` string — ID of the verifier
      - `dateCreated` string, date-time — Date the verifier was created. Dates are in ISO-8601 format. Example date (January 2nd 2014 12pm UTC): 2014-01-02T12:00:00.000+0000
      - `type` 'user', required
      - `user` User, required
        - `id` string — The identifier of this User
        - `profilePicUrl` string — The profile picture url for the user
        - `joinedDate` string, date-time
        - `userProfile` UserProfile — Specifies additional information about a Guru User
          - `roleLevel` string — The level at which the user operates in their current role
          - `useCaseList` UseCase[] — Describes different ways the user intends to use Guru
            - `description` string — A description of this use case
          - `role` string — The functional role a Guru user performs on their team
        - `lastName` string, required — The user's last name
        - `firstName` string, required — The user's first name
        - `status` 'ACTIVE' | 'PENDING' — The status of a User can be ACTIVE or PENDING. The User must verify their email address to be considered ACTIVE.
        - `email` string, required — The user's email address

## Response `200`

successful operation

- CardVerifiers
  - `verificationInitiator` User
    - `id` string — The identifier of this User
    - `profilePicUrl` string — The profile picture url for the user
    - `joinedDate` string, date-time
    - `userProfile` UserProfile — Specifies additional information about a Guru User
      - `roleLevel` string — The level at which the user operates in their current role
      - `useCaseList` UseCase[] — Describes different ways the user intends to use Guru
        - `description` string — A description of this use case
      - `role` string — The functional role a Guru user performs on their team
    - `lastName` string, required — The user's last name
    - `firstName` string, required — The user's first name
    - `status` 'ACTIVE' | 'PENDING' — The status of a User can be ACTIVE or PENDING. The User must verify their email address to be considered ACTIVE.
    - `email` string, required — The user's email address
  - `verifiers` CardVerifier[]
    - union
      - UserGroupVerifier
        - `id` string — ID of the verifier
        - `dateCreated` string, date-time — Date the verifier was created. Dates are in ISO-8601 format. Example date (January 2nd 2014 12pm UTC): 2014-01-02T12:00:00.000+0000
        - `type` 'user-group', required
        - `userGroup` UserGroup
          - `name` string — Group Name
          - `id` string — ID of the group
          - `members` UserGroupMember[]
            - `id` string — ID of the group member
            - `managedByScim` boolean
            - `dateCreated` string, date-time — Date the group member was added to the group. Dates are in ISO-8601 format. Example date (January 2nd 2014 12pm UTC): 2014-01-02T12:00:00.000+0000
            - `user` User, required
              - …
          - `expertIdRank` integer
          - `numberOfCardsAsVerifier` integer
          - `managedByScim` boolean
          - `groupIdentifier` string
          - `numberOfMembers` integer
          - `modifiable` boolean
          - `userModifiable` boolean
          - `singleUser` boolean
          - `team` Team
            - `name` string — Team Name
            - `id` string — ID of the fact
            - `profilePicUrl` string
            - `companyName` string — Team Company Name
            - `currentUserIsMember` boolean
            - `domain` string — Domain
            - `edition` TeamEdition
              - …
            - `billableUsers` integer
            - `totalUsers` integer
            - `teamDomains` TeamDomain[]
              - …
            - `slackCommandState` string
            - `slackCommandInstalled` boolean
            - `sfdcIntegrationState` string
            - `sfdcIntegrationInstalled` boolean
            - `clearProfilePic` boolean
            - `defaultGroup` UserGroup — recursive
            - `defaultUserType` 'FREE_CORE' | 'CORE'
            - `trialExpirationDate` string, date-time
            - `zendeskAssistState` string
            - `zendeskAssistInstalled` boolean
            - `zendeskKnowledgeState` string
            - `zendeskKnowledgeInstalled` boolean
            - `fileSharingDisabled` boolean
            - `collectionCreated` boolean
            - `teamCreationToken` string
            - `cardsCreated` integer
            - `topLevelOrganizationId` string
            - `numberOfCollections` integer
            - `numberOfOrgSharedCollections` integer
            - `allMembersGroupId` string
            - `deleted` boolean — Indicates if the fact has been deleted
            - `dateCreated` string, date-time — Date the team was created. Dates are in ISO-8601 format. Example date (January 2nd 2014 12pm UTC): 2014-01-02T12:00:00.000+0000
            - `userRole` string
            - `useCase` string
            - `description` string
            - `status` 'ACTIVE' | 'DORMANT' | 'LOCKED' | 'EXPIRED' | 'LOCKED_PAY'
            - `organization` Organization
              - …
          - `dateCreated` string, date-time — Date the group was created. Dates are in ISO-8601 format. Example date (January 2nd 2014 12pm UTC): 2014-01-02T12:00:00.000+0000
          - `role` 'ADMIN' | 'AUTHOR' | 'MEMBER' | 'COLL_ADMIN'
      - UserVerifier
        - `id` string — ID of the verifier
        - `dateCreated` string, date-time — Date the verifier was created. Dates are in ISO-8601 format. Example date (January 2nd 2014 12pm UTC): 2014-01-02T12:00:00.000+0000
        - `type` 'user', required
        - `user` User, required
          - `id` string — The identifier of this User
          - `profilePicUrl` string — The profile picture url for the user
          - `joinedDate` string, date-time
          - `userProfile` UserProfile — Specifies additional information about a Guru User
            - `roleLevel` string — The level at which the user operates in their current role
            - `useCaseList` UseCase[] — Describes different ways the user intends to use Guru
              - …
            - `role` string — The functional role a Guru user performs on their team
          - `lastName` string, required — The user's last name
          - `firstName` string, required — The user's first name
          - `status` 'ACTIVE' | 'PENDING' — The status of a User can be ACTIVE or PENDING. The User must verify their email address to be considered ACTIVE.
          - `email` string, required — The user's email address
  - `verificationState` 'TRUSTED' | 'STALE' | 'NEEDS_VERIFICATION' | 'SYNCED_NO_VERIFICATION'
  - `verificationReason` 'UPDATE' | 'NEW_VERIFIER' | 'QUESTION' | 'REQUESTED' | 'EXPIRED'

## Other responses

- `400` — Invalid/Incomplete Request
- `401` — Request was unauthorized
- `403` — Forbidden access to the resource
- `404` — Resource could not be found

---

[API](https://skmtc.net/getguru/apis/guru-api.md) · [All operations](https://skmtc.net/getguru/apis/guru-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getguru/guru-api/revisions/9090a01dfe1a/schema)