# Persona

> Run identity verification with Persona: create inquiries, send people the link, read the result, and approve or decline.

App · Compliance & Security · 20 actions. Web page: https://docs.lodol.com/docs/integrations/persona

## Actions

### Add a tag to an inquiry

Put one more tag on an inquiry, leaving its other tags alone.

**Inputs**

- Inquiry (`inquiry_id`, text, required): The inquiry's id, which starts 'inq_'. Use 'List inquiries' to find one -- it is also the last part of the inquiry's web address in the Persona dashboard, which you can paste whole.
- Tag name (`tag_name`, text): The tag's name. Give this or the tag id, not both.
- Tag id (`tag_id`, text): The tag's id. Give this or the tag name, not both.

**Outputs**

- `inquiry` (object): The inquiry after tagging.
- `inquiry_id` (text): The inquiry's id.
- `inquiry_status` (text): Where the inquiry has got to.
- `status` (text): Status of the action execution ("success" on success).
- `tags` (list): The tags the inquiry now has.

**Example output**

```json
{
  "inquiry": {
    "attributes": {
      "status": "created",
      "tags": [
        "signup",
        "priority"
      ]
    },
    "id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
    "type": "inquiry"
  },
  "inquiry_id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
  "inquiry_status": "created",
  "status": "success",
  "tags": [
    "signup",
    "priority"
  ]
}
```

### Approve an inquiry

Approve an inquiry. This is final: Persona runs the account's workflows and webhooks and the inquiry cannot progress any further afterwards.

**Inputs**

- Inquiry (`inquiry_id`, text, required): The inquiry's id, which starts 'inq_'. Use 'List inquiries' to find one -- it is also the last part of the inquiry's web address in the Persona dashboard, which you can paste whole.
- Comment (`comment`, text): An optional note recorded against the decision for auditing.

**Outputs**

- `inquiry` (object): The inquiry after approval.
- `inquiry_id` (text): The inquiry's id.
- `inquiry_status` (text): Where the inquiry has got to, normally 'approved'.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "inquiry": {
    "attributes": {
      "status": "approved"
    },
    "id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
    "type": "inquiry"
  },
  "inquiry_id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
  "inquiry_status": "approved",
  "status": "success"
}
```

### Create an account

Create the Persona account a person's inquiries and verifications hang off. Filling in 'Match existing by' turns this into an update when one already matches.

**Inputs**

- Account type (`account_type_id`, text): The account type to create this under (starts 'acttp_'). Leave blank for your organisation's default.
- Your own id for this person (`reference_id`, text): The id this person has in your own system. Persona stores it on the account so you can find them again without keeping Persona's id.
- Account status (`account_status`, text): The name of a status configured on this account type, such as 'Approved'. Leave blank to use the account type's default.
- Country code (`country_code`, text): The person's country as a two-letter ISO code, such as US.
- Tags (`tags`, list): The complete set of tags the account should end up with. Filling this in replaces the account's existing tags; leave it blank to leave them alone.
- Custom fields (`fields`, object): Any extra fields your account type defines, as a name-to-value object. Leave blank unless your account type has custom fields.
- Match existing by (`upsert_by`, text): The field name to match an existing account on, such as reference-id. It must be unique across accounts of this type. Leave blank to always create a new account.
- First name (`name_first`, text): The person's first name.
- Middle name (`name_middle`, text): The person's middle name.
- Last name (`name_last`, text): The person's last name.
- Email (`email_address`, text): The person's email address.
- Phone (`phone_number`, text): The person's phone number.
- Date of birth (`birthdate`, date): The person's date of birth.
- Street address (`address_street_1`, text): The first line of the person's address.
- Street address line 2 (`address_street_2`, text): The second line of the person's address.
- City (`address_city`, text): The person's city.
- State or province (`address_subdivision`, text): The person's state or province. In the US, write it out in full rather than abbreviating it.
- Postal code (`address_postal_code`, text): The person's postal or ZIP code.

**Outputs**

- `account` (object): The account.
- `account_id` (text): The account's id.
- `created` (true/false): True when a new account was made, false when 'Match existing by' found one and updated it instead.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "account": {
    "attributes": {
      "account-type-name": "Individual",
      "reference-id": "customer-8821"
    },
    "id": "act_8nT2pQrLmX9WvKcBd4Zf",
    "type": "account"
  },
  "account_id": "act_8nT2pQrLmX9WvKcBd4Zf",
  "created": true,
  "status": "success"
}
```

### Create an inquiry

Start a verification for one person and get the link to send them. Uses the inquiry template from your connection unless you name another one here.

**Inputs**

- Template (`inquiry_template_id`, text): The inquiry template to run (starts 'itmpl_'). Leave blank to use the one set on your Persona connection.
- Template version (`inquiry_template_version_id`, text): Pin the inquiry to one published version of a template (starts 'itmplv_'). Leave blank to use the template's current version.
- Legacy template (`template_id`, text): A Legacy 2.0 template (starts 'tmpl_'), for accounts still on the old flows. Use only one of the three template fields.
- Account (`account_id`, text): Attach the inquiry to an existing account (starts 'act_'). Leave blank to let Persona create one.
- Your own id for this person (`reference_id`, text): The id this person has in your own system. Persona stores it on the account so you can find them again without keeping Persona's id.
- Account type (`account_type_id`, text): The account type Persona should create the account as (starts 'acttp_'). Leave blank for your default type.
- Create an account automatically (`auto_create_account`, true/false): On (the default) creates an account for this person when none exists. Switch it off only if you are attaching an existing account -- Persona then rejects the two account fields above. Default: `true`.
- Generate a link to send (`auto_create_one_time_link`, true/false): On (the default) returns a one-time link you can email the person straight away. Default: `true`.
- Generate a session token (`auto_create_inquiry_session`, true/false): Also return a session token, for embedding the flow in your own app rather than sending a link. Default: `false`.
- Link expires after (seconds) (`one_time_link_expiration_seconds`, number): How long the one-time link stays usable. Leave blank for the template's own setting, which defaults to 24 hours. At least 1.
- Redirect to (`redirect_uri`, text): Where to send the person's browser once they finish the hosted flow.
- Created by (`creator_email_address`, text): The email address recorded as having started this.
- Note (`note`, text): A free-form note stored on the inquiry.
- Tags (`tags`, list): Tag names to put on the new inquiry.
- First name (`name_first`, text): The person's first name, pre-filled into the inquiry.
- Middle name (`name_middle`, text): The person's middle name.
- Last name (`name_last`, text): The person's last name.
- Email (`email_address`, text): The person's email address.
- Phone (`phone_number`, text): The person's phone number.
- Date of birth (`birthdate`, date): The person's date of birth.
- Street address (`address_street_1`, text): The first line of the person's address.
- Street address line 2 (`address_street_2`, text): The second line of the person's address.
- City (`address_city`, text): The person's city.
- State or province (`address_subdivision`, text): The person's state or province. In the US, write it out in full rather than abbreviating it.
- Postal code (`address_postal_code`, text): The person's postal or ZIP code.
- Country code (`address_country_code`, text): The person's country as a two-letter ISO code, such as US.

**Outputs**

- `inquiry` (object): The inquiry that was created.
- `inquiry_id` (text): The new inquiry's id.
- `inquiry_status` (text): Where the inquiry starts out, normally 'created'.
- `one_time_link` (text): The link to send the person, when one was asked for. Empty otherwise.
- `one_time_link_short` (text): A shortened form of the same link.
- `session_token` (text): A session token for embedding the flow, when one was asked for. Empty otherwise.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "inquiry": {
    "attributes": {
      "status": "created",
      "tags": [
        "signup"
      ]
    },
    "id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
    "type": "inquiry"
  },
  "inquiry_id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
  "inquiry_status": "created",
  "one_time_link": "https://withpersona.com/verify?inquiry-id=inq_4eC39HqLyjWDarjtT1zdp7dc",
  "one_time_link_short": "https://withpersona.com/l/9fQ2xa",
  "session_token": "",
  "status": "success"
}
```

### Decline an inquiry

Decline an inquiry. This is final: Persona runs the account's workflows and webhooks and the inquiry cannot progress any further afterwards.

**Inputs**

- Inquiry (`inquiry_id`, text, required): The inquiry's id, which starts 'inq_'. Use 'List inquiries' to find one -- it is also the last part of the inquiry's web address in the Persona dashboard, which you can paste whole.
- Comment (`comment`, text): An optional note recorded against the decision for auditing.

**Outputs**

- `inquiry` (object): The inquiry after the decline.
- `inquiry_id` (text): The inquiry's id.
- `inquiry_status` (text): Where the inquiry has got to, normally 'declined'.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "inquiry": {
    "attributes": {
      "status": "declined"
    },
    "id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
    "type": "inquiry"
  },
  "inquiry_id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
  "inquiry_status": "declined",
  "status": "success"
}
```

### Expire an inquiry

Expire an inquiry and close its open sessions, cancelling any verification still in progress. It can be resumed afterwards.

**Inputs**

- Inquiry (`inquiry_id`, text, required): The inquiry's id, which starts 'inq_'. Use 'List inquiries' to find one -- it is also the last part of the inquiry's web address in the Persona dashboard, which you can paste whole.

**Outputs**

- `inquiry` (object): The inquiry after expiring.
- `inquiry_id` (text): The inquiry's id.
- `inquiry_status` (text): Where the inquiry has got to, normally 'expired'.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "inquiry": {
    "attributes": {
      "status": "expired"
    },
    "id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
    "type": "inquiry"
  },
  "inquiry_id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
  "inquiry_status": "expired",
  "status": "success"
}
```

### Get a one-time link

Create a fresh single-use link to an existing inquiry: the URL you send the person so they can complete it.

**Inputs**

- Inquiry (`inquiry_id`, text, required): The inquiry's id, which starts 'inq_'. Use 'List inquiries' to find one -- it is also the last part of the inquiry's web address in the Persona dashboard, which you can paste whole.
- Expires after (seconds) (`expires_in_seconds`, number): How long the link stays usable. Leave blank for the template's own setting, which defaults to 24 hours. At least 1.

**Outputs**

- `inquiry` (object): The inquiry the link is for.
- `inquiry_id` (text): The inquiry's id.
- `inquiry_status` (text): Where the inquiry has got to.
- `one_time_link` (text): The single-use link to send the person.
- `one_time_link_short` (text): A shortened form of the same link.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "inquiry": {
    "attributes": {
      "status": "created"
    },
    "id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
    "type": "inquiry"
  },
  "inquiry_id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
  "inquiry_status": "created",
  "one_time_link": "https://withpersona.com/verify?inquiry-id=inq_4eC39HqLyjWDarjtT1zdp7dc",
  "one_time_link_short": "https://withpersona.com/l/9fQ2xa",
  "status": "success"
}
```

### Get a verification

Get one verification (a single check inside an inquiry, such as a government ID or a selfie) with every check it ran and why each passed or failed. Its id comes off an inquiry's verifications relationship.

**Inputs**

- Verification (`verification_id`, text, required): The verification's id, which starts 'ver_'. Get an inquiry and read it from its verifications relationship, or paste the dashboard address.

**Outputs**

- `checks` (list): Every individual check, with its result and reasons.
- `status` (text): Status of the action execution ("success" on success).
- `verification` (object): The verification, with its type-specific fields.
- `verification_id` (text): The verification's id.
- `verification_status` (text): Whether it passed, failed or is still running.
- `verification_type` (text): Which kind of verification this is, such as verification/government-id.

**Example output**

```json
{
  "checks": [
    {
      "name": "id_expired_detection",
      "reasons": [],
      "status": "passed"
    }
  ],
  "status": "success",
  "verification": {
    "attributes": {
      "checks": [
        {
          "name": "id_expired_detection",
          "reasons": [],
          "status": "passed"
        }
      ],
      "country-code": "US",
      "status": "passed"
    },
    "id": "ver_7kPq2mXnRt4YbVcLsD8W",
    "type": "verification/government-id"
  },
  "verification_id": "ver_7kPq2mXnRt4YbVcLsD8W",
  "verification_status": "passed",
  "verification_type": "verification/government-id"
}
```

### Get an account

Get one account in full, with the details Persona holds on it.

**Inputs**

- Account (`account_id`, text, required): The account's id, which starts 'act_'. Use 'List accounts' to find one, or paste the account's dashboard address.

**Outputs**

- `account` (object): The account.
- `account_id` (text): The account's id.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "account": {
    "attributes": {
      "account-type-name": "Individual",
      "reference-id": "customer-8821",
      "tags": [
        "signup"
      ]
    },
    "id": "act_8nT2pQrLmX9WvKcBd4Zf",
    "type": "account"
  },
  "account_id": "act_8nT2pQrLmX9WvKcBd4Zf",
  "status": "success"
}
```

### Get an inquiry

Get one inquiry in full, including the data it collected and the ids of the verifications inside it.

**Inputs**

- Inquiry (`inquiry_id`, text, required): The inquiry's id, which starts 'inq_'. Use 'List inquiries' to find one -- it is also the last part of the inquiry's web address in the Persona dashboard, which you can paste whole.

**Outputs**

- `inquiry` (object): The inquiry.
- `inquiry_id` (text): The inquiry's id.
- `inquiry_status` (text): Where the inquiry has got to.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "inquiry": {
    "attributes": {
      "status": "completed",
      "tags": [
        "signup"
      ]
    },
    "id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
    "type": "inquiry"
  },
  "inquiry_id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
  "inquiry_status": "completed",
  "status": "success"
}
```

### List accounts

List the people Persona holds accounts for, newest first, optionally narrowed to your own ids for them.

**Inputs**

- Your own ids (`reference_ids`, list): Only return accounts recorded against these ids from your own system.
- Maximum results (`page_size`, number): How many results to return per page (1-100). Persona uses 10 by default. From 1 to 100.
- After (`page_after`, text): Return the page that follows this record. Persona pages by object id, so this is the id of the last record on the previous page.
- Before (`page_before`, text): Return the page that precedes this record, given as an object id.

**Outputs**

- `accounts` (list): The accounts that matched, newest first.
- `count` (number): How many accounts were returned.
- `links` (object): Links to the previous and next pages, when there are any.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "accounts": [
    {
      "attributes": {
        "account-type-name": "Individual",
        "reference-id": "customer-8821",
        "tags": [
          "signup"
        ]
      },
      "id": "act_8nT2pQrLmX9WvKcBd4Zf",
      "type": "account"
    }
  ],
  "count": 1,
  "links": {
    "next": null,
    "prev": null
  },
  "status": "success"
}
```

### List inquiries

List verification inquiries, newest first, narrowed by status, account, template or when they were created.

**Inputs**

- Status (`statuses`, list): Only return inquiries in these statuses. One or more of: `created`, `pending`, `completed`, `expired`, `failed`, `needs_review` (Needs review), `approved`, `declined`.
- Accounts (`account_ids`, list): Only return inquiries belonging to these accounts.
- Inquiries (`inquiry_ids`, list): Only return these specific inquiries, by id.
- Your own id (`reference_id`, text): Only return inquiries recorded against this id from your own system.
- Template (`inquiry_template_id`, text): Only return inquiries made from this template (starts 'itmpl_').
- Legacy template (`template_id`, text): Only return inquiries made from this legacy template (starts 'tmpl_').
- Note (`note`, text): Only return inquiries carrying this note. Persona accepts this filter on its own, so clear the others when you use it.
- Created from (`created_at_start`, date and time): Only return inquiries created at or after this time.
- Created up to (`created_at_end`, date and time): Only return inquiries created at or before this time.
- Maximum results (`page_size`, number): How many results to return per page (1-100). Persona uses 10 by default. From 1 to 100.
- After (`page_after`, text): Return the page that follows this record. Persona pages by object id, so this is the id of the last record on the previous page.
- Before (`page_before`, text): Return the page that precedes this record, given as an object id.

**Outputs**

- `count` (number): How many inquiries were returned.
- `inquiries` (list): The inquiries that matched, newest first.
- `links` (object): Links to the previous and next pages, when there are any.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "count": 1,
  "inquiries": [
    {
      "attributes": {
        "reference-id": "customer-8821",
        "status": "completed",
        "tags": [
          "signup"
        ]
      },
      "id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
      "type": "inquiry"
    }
  ],
  "links": {
    "next": null,
    "prev": null
  },
  "status": "success"
}
```

### Mark an inquiry for review

Send an inquiry to your team's manual review queue. The inquiry stops progressing until someone decides it.

**Inputs**

- Inquiry (`inquiry_id`, text, required): The inquiry's id, which starts 'inq_'. Use 'List inquiries' to find one -- it is also the last part of the inquiry's web address in the Persona dashboard, which you can paste whole.

**Outputs**

- `inquiry` (object): The inquiry after being marked for review.
- `inquiry_id` (text): The inquiry's id.
- `inquiry_status` (text): Where the inquiry has got to, normally 'needs_review'.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "inquiry": {
    "attributes": {
      "status": "needs_review"
    },
    "id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
    "type": "inquiry"
  },
  "inquiry_id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
  "inquiry_status": "needs_review",
  "status": "success"
}
```

### Remove a tag from an inquiry

Take one tag off an inquiry, leaving its other tags alone.

**Inputs**

- Inquiry (`inquiry_id`, text, required): The inquiry's id, which starts 'inq_'. Use 'List inquiries' to find one -- it is also the last part of the inquiry's web address in the Persona dashboard, which you can paste whole.
- Tag name (`tag_name`, text): The tag's name. Give this or the tag id, not both.
- Tag id (`tag_id`, text): The tag's id. Give this or the tag name, not both.

**Outputs**

- `inquiry` (object): The inquiry after untagging.
- `inquiry_id` (text): The inquiry's id.
- `inquiry_status` (text): Where the inquiry has got to.
- `status` (text): Status of the action execution ("success" on success).
- `tags` (list): The tags the inquiry now has.

**Example output**

```json
{
  "inquiry": {
    "attributes": {
      "status": "created",
      "tags": [
        "signup"
      ]
    },
    "id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
    "type": "inquiry"
  },
  "inquiry_id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
  "inquiry_status": "created",
  "status": "success",
  "tags": [
    "signup"
  ]
}
```

### Resume an inquiry

Reopen an inquiry and get a fresh session token for it. Persona only allows this while the inquiry is pending or expired.

**Inputs**

- Inquiry (`inquiry_id`, text, required): The inquiry's id, which starts 'inq_'. Use 'List inquiries' to find one -- it is also the last part of the inquiry's web address in the Persona dashboard, which you can paste whole.

**Outputs**

- `inquiry` (object): The inquiry after resuming.
- `inquiry_id` (text): The inquiry's id.
- `inquiry_status` (text): Where the inquiry has got to, normally 'pending'.
- `session_token` (text): The new session token for the reopened inquiry.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "inquiry": {
    "attributes": {
      "status": "pending"
    },
    "id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
    "type": "inquiry"
  },
  "inquiry_id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
  "inquiry_status": "pending",
  "session_token": "sess_9fQ2xaLmN8",
  "status": "success"
}
```

### Set account tags

Set the tags on an account. This replaces its existing tags: any tag you leave out is removed, and an empty list clears them all.

**Inputs**

- Account (`account_id`, text, required): The account's id, which starts 'act_'. Use 'List accounts' to find one, or paste the account's dashboard address.
- Tag names (`tag_names`, list): The complete set of tag names the record should end up with. To add one, include the existing tags too -- anything left out is removed.
- Tag ids (`tag_ids`, list): The complete set of tag ids the record should end up with, for tags you address by id rather than by name.

**Outputs**

- `account` (object): The account after the change.
- `account_id` (text): The account's id.
- `status` (text): Status of the action execution ("success" on success).
- `tags` (list): The tags the account now has.

**Example output**

```json
{
  "account": {
    "attributes": {
      "tags": [
        "signup"
      ]
    },
    "id": "act_8nT2pQrLmX9WvKcBd4Zf",
    "type": "account"
  },
  "account_id": "act_8nT2pQrLmX9WvKcBd4Zf",
  "status": "success",
  "tags": [
    "signup"
  ]
}
```

### Set inquiry tags

Set the tags on an inquiry. This replaces its existing tags: any tag you leave out is removed, and an empty list clears them all.

**Inputs**

- Inquiry (`inquiry_id`, text, required): The inquiry's id, which starts 'inq_'. Use 'List inquiries' to find one -- it is also the last part of the inquiry's web address in the Persona dashboard, which you can paste whole.
- Tag names (`tag_names`, list): The complete set of tag names the record should end up with. To add one, include the existing tags too -- anything left out is removed.
- Tag ids (`tag_ids`, list): The complete set of tag ids the record should end up with, for tags you address by id rather than by name.

**Outputs**

- `inquiry` (object): The inquiry after the change.
- `inquiry_id` (text): The inquiry's id.
- `inquiry_status` (text): Where the inquiry has got to.
- `status` (text): Status of the action execution ("success" on success).
- `tags` (list): The tags the inquiry now has.

**Example output**

```json
{
  "inquiry": {
    "attributes": {
      "status": "created",
      "tags": [
        "signup"
      ]
    },
    "id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
    "type": "inquiry"
  },
  "inquiry_id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
  "inquiry_status": "created",
  "status": "success",
  "tags": [
    "signup"
  ]
}
```

### Simulate inquiry actions

Move a Sandbox inquiry through its lifecycle without anyone completing the flow: the way to test a workflow end to end. Sandbox only: a production API key is refused. The actions run in Persona's lifecycle order whichever order you tick them in.

**Inputs**

- Inquiry (`inquiry_id`, text, required): The inquiry's id, which starts 'inq_'. Use 'List inquiries' to find one -- it is also the last part of the inquiry's web address in the Persona dashboard, which you can paste whole.
- Actions to simulate (`simulate_actions`, list, required): What should happen to the inquiry. Each one fires the same events a real inquiry would. One or more of: `start_inquiry` (Start inquiry), `create_passed_verification` (Create passed verification), `create_failed_verification` (Create failed verification), `complete_inquiry` (Complete inquiry), `fail_inquiry` (Fail inquiry), `expire_inquiry` (Expire inquiry), `mark_for_review_inquiry` (Mark for review inquiry), `approve_inquiry` (Approve inquiry), `decline_inquiry` (Decline inquiry).
- Verification template (`verification_template_id`, text): Only needed for the two 'create verification' actions: the token of the verification template to simulate, from Verifications > Templates in the dashboard.

**Outputs**

- `inquiry` (object): The inquiry after the simulated actions.
- `inquiry_id` (text): The inquiry's id.
- `inquiry_status` (text): Where the inquiry has got to.
- `simulated_actions` (list): The actions that were run, in the order they ran.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "inquiry": {
    "attributes": {
      "status": "completed"
    },
    "id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
    "type": "inquiry"
  },
  "inquiry_id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
  "inquiry_status": "completed",
  "simulated_actions": [
    "start_inquiry",
    "complete_inquiry"
  ],
  "status": "success"
}
```

### Update an account

Change the details on an account. Only the fields you fill in are changed, but filling in Tags replaces the account's whole tag set. An account's type cannot be changed.

**Inputs**

- Account (`account_id`, text, required): The account's id, which starts 'act_'. Use 'List accounts' to find one, or paste the account's dashboard address.
- Your own id for this person (`reference_id`, text): The id this person has in your own system. Persona stores it on the account so you can find them again without keeping Persona's id.
- Account status (`account_status`, text): The name of a status configured on this account type, such as 'Approved'. Leave blank to use the account type's default.
- Country code (`country_code`, text): The person's country as a two-letter ISO code, such as US.
- Tags (`tags`, list): The complete set of tags the account should end up with. Filling this in replaces the account's existing tags; leave it blank to leave them alone.
- Custom fields (`fields`, object): Any extra fields your account type defines, as a name-to-value object. Leave blank unless your account type has custom fields.
- First name (`name_first`, text): The person's first name.
- Middle name (`name_middle`, text): The person's middle name.
- Last name (`name_last`, text): The person's last name.
- Email (`email_address`, text): The person's email address.
- Phone (`phone_number`, text): The person's phone number.
- Date of birth (`birthdate`, date): The person's date of birth.
- Street address (`address_street_1`, text): The first line of the person's address.
- Street address line 2 (`address_street_2`, text): The second line of the person's address.
- City (`address_city`, text): The person's city.
- State or province (`address_subdivision`, text): The person's state or province. In the US, write it out in full rather than abbreviating it.
- Postal code (`address_postal_code`, text): The person's postal or ZIP code.

**Outputs**

- `account` (object): The account after the update.
- `account_id` (text): The account's id.
- `status` (text): Status of the action execution ("success" on success).
- `updated_fields` (list): The names of the fields that were changed.

**Example output**

```json
{
  "account": {
    "attributes": {
      "account-status": "Approved"
    },
    "id": "act_8nT2pQrLmX9WvKcBd4Zf",
    "type": "account"
  },
  "account_id": "act_8nT2pQrLmX9WvKcBd4Zf",
  "status": "success",
  "updated_fields": [
    "account-status"
  ]
}
```

### Update an inquiry

Change an inquiry's note, pre-filled details or tags. Only the fields you fill in are changed, but filling in Tags replaces the inquiry's whole tag set.

**Inputs**

- Inquiry (`inquiry_id`, text, required): The inquiry's id, which starts 'inq_'. Use 'List inquiries' to find one -- it is also the last part of the inquiry's web address in the Persona dashboard, which you can paste whole.
- Note (`note`, text): A free-form note stored on the inquiry.
- Redirect to (`redirect_uri`, text): Where to send the person's browser once they finish the hosted flow.
- Tags (`tags`, list): The complete set of tags the inquiry should end up with. Anything left out is removed; leave this blank to leave the tags alone.
- First name (`name_first`, text): The person's first name, pre-filled into the inquiry.
- Middle name (`name_middle`, text): The person's middle name.
- Last name (`name_last`, text): The person's last name.
- Email (`email_address`, text): The person's email address.
- Phone (`phone_number`, text): The person's phone number.
- Date of birth (`birthdate`, date): The person's date of birth.
- Street address (`address_street_1`, text): The first line of the person's address.
- Street address line 2 (`address_street_2`, text): The second line of the person's address.
- City (`address_city`, text): The person's city.
- State or province (`address_subdivision`, text): The person's state or province. In the US, write it out in full rather than abbreviating it.
- Postal code (`address_postal_code`, text): The person's postal or ZIP code.
- Country code (`address_country_code`, text): The person's country as a two-letter ISO code, such as US.

**Outputs**

- `inquiry` (object): The inquiry after the update.
- `inquiry_id` (text): The inquiry's id.
- `inquiry_status` (text): Where the inquiry has got to.
- `status` (text): Status of the action execution ("success" on success).
- `updated_fields` (list): The names of the fields that were changed.

**Example output**

```json
{
  "inquiry": {
    "attributes": {
      "note": "Priority review",
      "status": "created"
    },
    "id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
    "type": "inquiry"
  },
  "inquiry_id": "inq_4eC39HqLyjWDarjtT1zdp7dc",
  "inquiry_status": "created",
  "status": "success",
  "updated_fields": [
    "note"
  ]
}
```