Adobe Suite

Adobe Suite User Management API

Marketo Engage provides a set of User Management endpoints allow you to perform CRUD operations on user records in Marketo.

Documentation GitHub OpenAPI

Business capability

Identity & Access Management BC-620.20

Operations 12

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 /userservice/management/v1/users/allusers.json List all users · Get Users #

Ask an LLM

“How do I get a list of every user in my Marketo instance?”

“Can I page through user records with an offset and page size?”

Tell an agent

List all users.

Get {pageSize} user records starting at offset {pageOffset}.

POST /userservice/management/v1/users/invite.json Invite a new user by email · Invite User #

Ask an LLM

“How can I send an email invitation to add a new user?”

“Can I create an API-only user or set an access expiry when inviting someone?”

Tell an agent

Invite {firstName} {lastName} at {emailAddress} with roles and workspaces {userRoleWorkspaces}.

Send an invitation to {emailAddress} that expires at {expiresAt}.

GET /userservice/management/v1/users/roles.json List available roles · Get Roles #

Ask an LLM

“What roles can be assigned to users?”

“Where do I get the full list of role records?”

Tell an agent

List all roles.

Show me every role that exists in the instance.

GET /userservice/management/v1/users/workspaces.json List workspaces · Get Workspaces #

Ask an LLM

“Which workspaces exist that users can be given access to?”

“Can I retrieve all workspace records?”

Tell an agent

List all workspaces.

Show me the workspace records.

POST /userservice/management/v1/users/{userid}/delete.json Delete an active user · Delete User #

Ask an LLM

“How do I remove a user who has already accepted their invitation?”

“Can I permanently delete a user account?”

Tell an agent destructive · confirm first

Delete user {userid}.

Remove the active user account {userid}.

POST /userservice/management/v1/users/{userid}/invite/delete.json Revoke a pending user invitation · Delete Invited User #

Ask an LLM

“Can I cancel an invitation that someone hasn't accepted yet?”

“How do I delete a pending user?”

Tell an agent destructive · confirm first

Delete the pending invitation for {userid}.

Withdraw the invite sent to user {userid} who hasn't accepted.

POST /userservice/management/v1/users/{userid}/update.json Update a user's attributes · Update User Attributes #

Ask an LLM

“How do I change a user's name or email address?”

“Can I update when a user's access expires?”

Tell an agent

Change the email of user {userid} to {emailAddress}.

Set user {userid}'s access to expire at {expiresAt}.

GET /userservice/management/v1/users/{userid}/roles.json Get a user's roles and workspaces · Get Roles and Workspaces by Id #

Ask an LLM

“Which roles and workspaces does a specific user have?”

“How can I audit what access one user has been granted?”

Tell an agent

Show the roles and workspaces for user {userid}.

List what access user {userid} holds across workspaces.

POST /userservice/management/v1/users/{userid}/roles/create.json Add roles to a user · Add Roles #

Ask an LLM

“How do I grant additional roles to an existing user?”

“Can I give a user a role in another workspace?”

Tell an agent

Add the roles {input} to user {userid}.

Grant user {userid} these role-workspace pairs: {input}.

POST /userservice/management/v1/users/{userid}/roles/delete.json Remove roles from a user · Delete Roles #

Ask an LLM

“How can I take a role away from a user?”

“Can I strip a user's access to a workspace by removing its role?”

Tell an agent destructive · confirm first

Remove the roles {input} from user {userid}.

Revoke these role assignments for user {userid}: {input}.

GET /userservice/management/v1/users/{userid}/user.json Get an active user by ID · Get User by Id #

Ask an LLM

“How do I look up one user's record by ID?”

“What details are stored on a single user?”

Tell an agent

Get user {userid}.

Show the user record for {userid}.

GET /userservice/management/v1/users/{userid}/invite.json Get a pending invited user by ID · Get Invited User by Id #

Ask an LLM

“Can I see the details of someone I invited who hasn't accepted yet?”

“How do I check a pending user's invitation record?”

Tell an agent

Get the pending invited user {userid}.

Show the invitation details for not-yet-accepted user {userid}.

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/adobe-suite:adobe-suite-user-management-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

openapi: 3.2.0
info:
  description: Marketo Engage Rest API
  version: '1.0'
  title: Marketo Engage Rest User Management API
  termsOfService: https://www.marketo.com/company/legal/
  contact:
    name: Adobe Developer Relations
    url: https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/home
    email: ''
  license:
    name: API License Agreement
    url: https://experienceleague.adobe.com/en/docs/marketo-developer/marketo/api-license
servers:
- url: https://localhost:8080/
tags:
- name: User Management
  description: Marketo Engage provides a set of User Management endpoints allow you to perform CRUD operations on user records in Marketo.
paths:
  /userservice/management/v1/users/allusers.json:
    get:
      tags:
      - User Management
      summary: Get Users
      description: 'Retrieve a list of all user records. Required Permissions: Access User Management Api and Access Users'
      operationId: getUsersUsingGET
      parameters:
      - name: pageOffset
        in: query
        description: Integer offset for paging.  Default is 0
        required: false
        schema:
          type: integer
          format: int32
          default: 0
      - name: pageSize
        in: query
        description: Maximum number of users to return.  Max 200, default 20
        required: false
        schema:
          type: integer
          format: int32
          default: 20
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ResponseOfAllUsers'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
  /userservice/management/v1/users/invite.json:
    post:
      tags:
      - User Management
      summary: Invite User
      description: 'Send an email invitation to new user. Required Permissions: Access User Management Api and Access Users'
      operationId: inviteUserUsingPOST
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: string
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InviteUserRequest'
        description: inviteUserRequest
        required: true
  /userservice/management/v1/users/roles.json:
    get:
      tags:
      - User Management
      summary: Get Roles
      description: 'Retrieve list of all role records. Required Permissions: Access User Management Api and Access Users'
      operationId: getRolesUsingGET
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ResponseOfRole'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
  /userservice/management/v1/users/workspaces.json:
    get:
      tags:
      - User Management
      summary: Get Workspaces
      description: 'Retrieve list of workspace records. Required Permissions: Access User Management Api and Access Users'
      operationId: getWorkspacesUsingGET
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ResponseOfWorkspace'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
  /userservice/management/v1/users/{userid}/delete.json:
    post:
      tags:
      - User Management
      summary: Delete User
      description: 'Delete user. Required Permissions: Access User Management Api and Access Users'
      operationId: deleteUserUsingPOST
      parameters:
      - name: userid
        in: path
        description: User id in the form of an email address
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
  /userservice/management/v1/users/{userid}/invite/delete.json:
    post:
      tags:
      - User Management
      summary: Delete Invited User
      description: 'Delete pending user. A pending user is a user that has not yet accepted invitation. Required Permissions: Access User Management Api and Access Users'
      operationId: deleteInvitedUserUsingPOST
      parameters:
      - name: userid
        in: path
        description: User id in the form of an email address
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
  /userservice/management/v1/users/{userid}/update.json:
    post:
      tags:
      - User Management
      summary: Update User Attributes
      description: 'Update one or more user attributes. Required Permissions: Access User Management Api and Access Users'
      operationId: updateUserAttributeUsingPOST
      parameters:
      - name: userid
        in: path
        description: User id in the form of an email address
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseOfUser'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateUserAttributesRequest'
        description: updateUserAttributesRequest
        required: true
  /userservice/management/v1/users/{userid}/roles.json:
    get:
      tags:
      - User Management
      summary: Get Roles and Workspaces by Id
      description: 'Get roles and workspaces for a given user. Required Permissions: Access User Management Api and Access Users'
      operationId: getUserRolesAndWorkspacesUsingGET
      parameters:
      - name: userid
        in: path
        description: User id in the form of an email address
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/UserRoleWorkspace'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
  /userservice/management/v1/users/{userid}/roles/create.json:
    post:
      tags:
      - User Management
      summary: Add Roles
      description: 'Add roles to a user. Required Permissions: Access User Management Api and Access Users'
      operationId: addRolesUsingPOST
      parameters:
      - name: userid
        in: path
        description: User id in the form of an email address
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/UserRoleWorkspace'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddRolesRequest'
        description: addRolesRequest
        required: true
  /userservice/management/v1/users/{userid}/roles/delete.json:
    post:
      tags:
      - User Management
      summary: Delete Roles
      description: 'Delete roles from user. Required Permissions: Access User Management Api and Access Users'
      operationId: deleteRolesUsingPOST
      parameters:
      - name: userid
        in: path
        description: User id in the form of an email address
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/UserRoleWorkspace'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteRolesRequest'
        description: deleteRolesRequest
        required: true
  /userservice/management/v1/users/{userid}/user.json:
    get:
      tags:
      - User Management
      summary: Get User by Id
      description: 'Retrieve a single user record through its Id. Required Permissions: Access User Management Api and Access Users'
      operationId: getUserUsingGET
      parameters:
      - name: userid
        in: path
        description: User id in the form of an email address
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseOfUser'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
  /userservice/management/v1/users/{userid}/invite.json:
    get:
      tags:
      - User Management
      summary: Get Invited User by Id
      description: 'Retrieve a single pending user record through its Id. A pending user is a user that has not yet accepted invitation. Required Permissions: Access User Management Api and Access Users'
      operationId: getInvitedUserUsingGET
      parameters:
      - name: userid
        in: path
        description: User id in the form of an email address
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseOfInvitedUser'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      deprecated: false
components:
  schemas:
    DeleteRolesRequest:
      type: object
      required:
      - input
      properties:
        input:
          type: array
          description: List of roles to delete
          items:
            $ref: '#/components/schemas/UserRoleWorkspaceId'
    ResponseOfRole:
      type: object
      required:
      - description
      - id
      - isHidden
      - isOnlyAllZones
      - name
      - createdAt
      - updatedAt
      - type
      properties:
        errors:
          type: array
          description: Array of errors that occurred if the request was unsuccessful
          items:
            $ref: '#/components/schemas/Error'
        description:
          type: string
          description: Role description
        id:
          type: integer
          description: Role id
          format: int32
        isHidden:
          type: boolean
          description: Whether role is hidden
        isOnlyAllZones:
          type: boolean
          description: Whether role is all zones
        name:
          type: string
          description: Role name
        createdAt:
          type: string
          description: Role creation time
        updatedAt:
          type: string
          description: Role update time
        type:
          type: string
          description: Role type
      title: ResponseOfRole
    InviteUserRequest:
      type: object
      required:
      - emailAddress
      - firstName
      - lastName
      - userRoleWorkspaces
      properties:
        apiOnly:
          type: boolean
          description: Whether the user is API-Only.  Default is false
        emailAddress:
          type: string
          description: User email address
          minLength: 1
          maxLength: 2147483647
          pattern: ^("?)(?:[^"])(?:[-\w.!#$%&\'*+\/=?^_`{|}~])*\1@(\w[-\w]{0,62}\.)+[A-Za-z]{2,63}$
        expiresAt:
          type: string
          description: Date and time when user login expires.  Must be valid ISO-8601 string.  See <a href="http://developers.marketo.com/rest-api/lead-database/fields/field-types/">Datetime</a> field type description.
        firstName:
          type: string
          description: User first name
        lastName:
          type: string
          description: User last name
        userid:
          type: string
          description: Marketo Identity users should use an email address. Adobe Identity users should use the generated GUID.
        reason:
          type: string
          description: Reason for user invitation
        userRoleWorkspaces:
          type: array
          items:
            $ref: '#/components/schemas/UserRoleWorkspaceId'
      title: InviteUserRequest
    ResponseOfUser:
      type: object
      required:
      - userid
      - firstName
      - lastName
      - emailAddress
      - optedIn
      - failedLogins
      - failedDeviceCode
      - isLocked
      - lockedReason
      - id
      - apiOnly
      - userRoleWorkspaces
      - expiresAt
      - lastLoginAt
      properties:
        errors:
          type: array
          description: Array of errors that occurred if the request was unsuccessful
          items:
            $ref: '#/components/schemas/Error'
        apiOnly:
          type: boolean
          description: Whether the user is API-Only
        emailAddress:
          type: string
          description: User email address
        expiresAt:
          type: string
          description: 'Date and time when user login expires.  Example: yyyy-MM-dd''T''HH:mm:ss.SSS''t''Z'
          example: yyyy-MM-dd'T'HH:mm:ss.SSS't'Z
        lastLoginAt:
          type: string
          description: 'Date and time of user''s most recent login.  Example: yyyy-MM-dd''T''HH:mm:ss.SSS''t''Z'
          example: yyyy-MM-dd'T'HH:mm:ss.SSS't'Z
        failedDeviceCode:
          type: integer
          description: Device code for user login failure
          format: int32
        failedLogins:
          type: integer
          description: Count of user login failures
          format: int32
        firstName:
          type: string
          description: User first name
        id:
          type: integer
          description: User identifier
          format: int32
        isLocked:
          type: boolean
          description: Whether user account is locked
        lastName:
          type: string
          description: User last name
        lockedReason:
          type: string
          description: Reason that user account is locked
        optedIn:
          type: boolean
          description: Whether user has opted in
        userRoleWorkspaces:
          type: array
          items:
            $ref: '#/components/schemas/UserRoleWorkspace'
        userid:
          type: string
          description: Marketo Identity users should use an email address. Adobe Identity users should use the generated GUID.
      title: ResponseOfUser
    ResponseOfWorkspace:
      type: object
      required:
      - currencyInfo
      - description
      - globalViz
      - id
      - name
      - status
      properties:
        errors:
          type: array
          description: Array of errors that occurred if the request was unsuccessful
          items:
            $ref: '#/components/schemas/Error'
        currencyInfo:
          type: string
          description: Workspace currency information
        description:
          type: string
          description: Workspace description
        globalViz:
          type: integer
          description: Workspace global visualization
          format: int32
        id:
          type: integer
          description: Workspace id
          format: int32
        name:
          type: string
          description: Workspace name
        createdAt:
          type: string
          description: Workspace creation time
        updatedAt:
          type: string
          description: Workspace updated time
        status:
          type: string
          description: Workspace status
      title: ResponseOfWorkspace
    ResponseOfInvitedUser:
      type: object
      required:
      - id
      - firstName
      - lastName
      - emailAddress
      - userid
      - subscriptionId
      - status
      - expiresAt
      - createdAt
      - updatedAt
      properties:
        errors:
          type: array
          description: Array of errors that occurred if the request was unsuccessful
          items:
            $ref: '#/components/schemas/Error'
        id:
          type: integer
          description: User identifier
          format: int32
        firstName:
          type: string
          description: User first name
        lastName:
          type: string
          description: User last name
        emailAddress:
          type: string
          description: User email address
        userid:
          type: string
          description: Marketo Identity users should use an email address. Adobe Identity users should use the generated GUID.
        subscriptionId:
          type: string
          description: Subscription ID
        status:
          type: string
          enum:
          - pending
          description: User status
        expiresAt:
          type: string
          description: 'Date and time when user login expires.  Example: yyyy-MM-dd''T''HH:mm:ss.SSS''t''Z'
          example: yyyy-MM-dd'T'HH:mm:ss.SSS't'Z
        createdAt:
          type: string
          description: 'Date and time when user login was created.  Example: yyyy-MM-dd''T''HH:mm:ss.SSS''t''Z'
          example: yyyy-MM-dd'T'HH:mm:ss.SSS't'Z
        updatedAt:
          type: string
          description: 'Date and time when user login was last updated.  Example: yyyy-MM-dd''T''HH:mm:ss.SSS''t''Z'
          example: yyyy-MM-dd'T'HH:mm:ss.SSS't'Z
      title: ResponseOfInvitedUser
    Error:
      type: object
      required:
      - code
      - message
      properties:
        code:
          type: integer
          format: int32
          description: Integer error code of the error
        message:
          type: string
          description: Message describing the cause of the Error
    UserRoleWorkspace:
      type: object
      required:
      - accessRoleId
      - workspaceId
      properties:
        accessRoleId:
          type: integer
          description: User role Id
          format: int32
        accessRoleName:
          type: string
          description: User role description
        workspaceId:
          type: integer
          description: User workspace Id
          format: int32
        workspaceName:
          type: string
          description: User workspace name
      title: UserRoleWorkspace
    UpdateUserAttributesRequest:
      type: object
      properties:
        apiOnly:
          type: boolean
          description: Whether the user is API-Only.  Default is false
        emailAddress:
          type: string
          description: User email address
          minLength: 1
          maxLength: 2147483647
          pattern: ^("?)(?:[^"])(?:[-\w.!#$%&\'*+\/=?^_`{|}~])*\1@(\w[-\w]{0,62}\.)+[A-Za-z]{2,63}$
        expiresAt:
          type: string
          description: 'Date and time when user login expires.  Example: yyyy-MM-dd''T''HH:mm:ss.SSS''t''Z'
          example: yyyyMMdd'T'HH:mm:ss'.'S't'Z
        firstName:
          type: string
          description: User first name
        lastName:
          type: string
          description: User last name
      title: UpdateUserAttributesRequest
    ResponseOfAllUsers:
      type: object
      required:
      - userid
      - firstName
      - lastName
      - emailAddress
      - id
      - apiOnly
      properties:
        errors:
          type: array
          description: Array of errors that occurred if the request was unsuccessful
          items:
            $ref: '#/components/schemas/Error'
        apiOnly:
          type: boolean
          description: Whether the user is API-Only
        emailAddress:
          type: string
          description: User email address
        firstName:
          type: string
          description: User first name
        id:
          type: integer
          description: User identifier
          format: int32
        lastName:
          type: string
          description: User last name
        userid:
          type: string
          description: Marketo Identity users should use an email address. Adobe Identity users should use the generated GUID.
      title: ResponseOfAllUsers
    AddRolesRequest:
      type: object
      required:
      - input
      properties:
        input:
          type: array
          description: List of roles to add
          items:
            $ref: '#/components/schemas/UserRoleWorkspaceId'
    UserRoleWorkspaceId:
      type: object
      required:
      - accessRoleId
      - workspaceId
      properties:
        accessRoleId:
          type: integer
          format: int32
          description: User role id
        workspaceId:
          type: integer
          format: int32
          description: User workspace id

Adobe Suite User Management API

Operations 12

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification