Drata

Drata Account Members API

The Account Members API from Drata — 3 operation(s) for account members.

GitHub OpenAPI

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /accounts/members Search account members · Search for members #
Ask an LLM
“Which accounts does a given member email belong to?”
“Can I search members by the account's Salesforce ID?”
Tell an agent
Find accounts that include member {email}.
Search members of the account with Salesforce ID {sfdcAccountId}.
POST /accounts/{id}/members Add members to an account · Add a member #
Ask an LLM
“How do I add people to a customer account?”
“Can I include a custom message when adding members?”
Tell an agent
Add members {members} to account {id}.
Add {members} to account {id} with the message {message}.
DELETE /accounts/{id}/members Remove members from an account · Delete a member #
Ask an LLM
“How do I take someone off a customer account?”
“Can I remove several members from an account by email at once?”
Tell an agent destructive · confirm first
Remove members {members} from account {id}.
Delete the member emails {members} from account {id}.
POST /accounts/{id}/members/notify Email an invitation to account members · Notify a member #
Ask an LLM
“What's the way to resend an invitation email to an account member?”
“Can I notify several members of an account in one request?”
Tell an agent
Send an invitation email to {email} for account {id}.
Notify members {email} of account {id} with message {message}.

Documentation

📖
Documentation
https://developers.drata.com/openapi/reference/v2/overview/
📖
APIReference
https://developers.drata.com/openapi/reference/v2/overview/
📖
GettingStarted
https://developers.drata.com/developer-portal/v2/recipes/create-an-api-key/
📖
Authentication
https://artifacts.apis.io/drata/authentication/drata-authentication.yml
📖
Documentation
https://developers.drata.com/openapi/reference/v2/tag/Custom-Connections/
📖
GettingStarted
https://developers.drata.com/developer-portal/v2/recipes/custom-connections/
📖
Documentation
https://docs.safebase.io/reference/getaccounts
📖
APIReference
https://docs.safebase.io/reference/getaccounts

Specifications

⚙
OpenAPI
https://artifacts.apis.io/drata/openapi/drata-account-members-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/drata:drata-account-members-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

drata-account-members-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: SafeBase API documentation.
  version: 1.4.1
  title: SafeBase API documentation Account Members API
  contact:
    email: support@safebase.io
servers:
- url: https://app.safebase.io/api/ext/v1/rest
security:
- apiKey: []
tags:
- name: Account Members
paths:
  /accounts/members:
    get:
      tags:
      - Account Members
      summary: Search for members
      description: Search for a member based on account criteria and member criteria
      operationId: searchForAccountMembers
      parameters:
      - in: query
        name: email
        description: This parameter will search for all accounts that contain a given member email.
        schema:
          type: string
      - in: query
        name: sfdcAccountId
        description: Salesforce Account Id to verify and get account
        schema:
          type: string
      responses:
        '201':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    example: true
                  result:
                    type: array
                    items:
                      $ref: '#/components/schemas/AccountMemberResponse'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
      security:
      - apiKey:
        - accounts:view
  /accounts/{id}/members:
    post:
      tags:
      - Account Members
      summary: Add a member
      description: Adds a member to an account
      operationId: addMemberToAccount
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountMemberPayloadArray'
      parameters:
      - $ref: '#/components/parameters/accountId'
      responses:
        '201':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    example: true
                  result:
                    $ref: '#/components/schemas/AccountMemberArrayResponse'
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
      security:
      - apiKey:
        - accounts:edit
    delete:
      tags:
      - Account Members
      summary: Delete a member
      description: Deletes a member from an account
      operationId: deleteMemberFromAccount
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountMemberEmails'
      parameters:
      - $ref: '#/components/parameters/accountId'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    example: true
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
      security:
      - apiKey:
        - accounts:edit
  /accounts/{id}/members/notify:
    post:
      tags:
      - Account Members
      summary: Notify a member
      description: 'Sends an email invitation to an account member.


        **email**: This parameter can be a single email (string) to notify one member, or an array of emails (string[]) to notify multiple members.


        **message** (optional): This parameter allows you to send a custom message in an invitation email.'
      operationId: accountMemberNotify
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountMemberNotifyPayload'
      parameters:
      - $ref: '#/components/parameters/accountId'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    example: true
        '400':
          $ref: '#/components/responses/400'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
      security:
      - apiKey:
        - accounts:edit
components:
  schemas:
    ApiResponseNotFound:
      type: object
      properties:
        statusCode:
          type: integer
          example: 404
        error:
          type: string
          example: not_found
        message:
          type: string
          example: Not found
    AccountMemberEmails:
      type: object
      required:
      - members
      properties:
        members:
          type: array
          description: Array of member emails to delete
          minItems: 1
          uniqueItems: true
          example:
          - user1@safebase.io
          - user2@safebase.io
          items:
            type: string
    AccountMemberResponse:
      type: object
      properties:
        accountId:
          type: string
          example: 88f54931-f4c6-454e-8c3d-1462df981b4d
        firstName:
          type: string
          example: Safe
        lastName:
          type: string
          example: Base
        name:
          type: string
          example: Safe Base
          deprecated: true
        email:
          type: string
          example: user@safebase.io
        createdAt:
          type: string
          format: date-time
          example: '2017-07-21T17:32:28Z'
        lastSeen:
          oneOf:
          - type: 'null'
          - type: string
            format: date-time
          example: '2017-07-21T17:32:28Z'
    AccountMemberEmail:
      type: string
      example: user1@safebase.io
    AccountMemberPayloadArray:
      type: object
      required:
      - members
      properties:
        members:
          description: An array of objects, each representing a member to add to an account
          type: array
          minItems: 1
          items:
            type: object
            $ref: '#/components/schemas/AccountMemberPayload'
        message:
          description: "This parameter allows you to send a custom message. It can be set to one of the following options: \n\n1. string - Sends a Safebase email with a custom message attached \n\n2. boolean - Set this parameter to 'true' to send a SafeBase email without any custom message \n\n3. undefined - If you do not wish to send a Safebase email, simply do not send this property as part of your request"
          oneOf:
          - type: string
            description: Enter the 'string' option here
          - type: boolean
            description: Enter the 'boolean' option here
          example: This is a custom message
    AccountMemberPayload:
      type: object
      required:
      - email
      properties:
        firstName:
          type: string
          example: Safe
          description: Required if name is not set.
        lastName:
          type: string
          example: Base
          description: Required if name is not set.
        name:
          type: string
          example: Safe Base
          description: Either firstName and lastName, or name must be supplied, but never all three.
          deprecated: true
        email:
          type: string
          example: user@safebase.io
    ApiResponseInvalidApiKeyOrMissingScope:
      type: object
      properties:
        statusCode:
          type: integer
          example: 403
        error:
          type: string
          example: forbidden
        message:
          type: string
          example: 'Invalid API key / Missing required scope(s): (missing scopes here)'
    AccountMemberArrayResponse:
      type: array
      items:
        type: object
        $ref: '#/components/schemas/AccountMemberResponse'
    AccountMemberNotifyPayload:
      type: object
      required:
      - email
      properties:
        email:
          oneOf:
          - $ref: '#/components/schemas/AccountMemberEmail'
            description: One single email address can be entered here
          - $ref: '#/components/schemas/AccountMemberEmails'
            description: An array of email addresses can be entered here
        message:
          description: "This parameter allows you to send a custom message. It can be set to one of the following options: \n\n1. string - Sends a Safebase email with a custom message attached \n\n2. boolean - Set this parameter to 'true' to send a SafeBase email without any custom message \n\n3. undefined - If you do not wish to send a Safebase email, simply do not send this property as part of your request"
          oneOf:
          - type: string
            description: Enter the 'string' option here
          - type: boolean
            description: Enter the 'boolean' option here
          example: This is a custom message
        notify:
          type: object
          itemUid:
            description: This is a parameter to be able to send a link directly to a specific Item on the Portal
            type: string
            format: uuid
          productId:
            description: The specific product to link to
            type: string
    ApiResponseInvalidRequest:
      type: object
      properties:
        statusCode:
          type: integer
          example: 400
        error:
          type: string
          example: bad_request
        message:
          type: string
          example: Invalid request.
  responses:
    '400':
      description: Invalid request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiResponseInvalidRequest'
    '404':
      description: Not found or no access
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiResponseNotFound'
    '405':
      description: Method not allowed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiResponseNotFound'
    '403':
      description: Invalid api key / missing scope
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiResponseInvalidApiKeyOrMissingScope'
  parameters:
    accountId:
      name: id
      in: path
      required: true
      schema:
        description: The target account ID
        type: string
        format: uuid
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-sb-api-key
      in: header