# TestGorilla

> Read assessments and results, manage candidate invitations and stages, and update assessment public links.

App · 13 actions. Web page: https://docs.lodol.com/docs/integrations/testgorilla

## Actions

### Change candidate stage

Change candidate stage.

**Inputs**

- Candidature id (`candidature_id`, text, required): The invitation ID, not the candidate test-taker ID.
- Stage (`stage`, text, required): Stage to use. One of: `NYE`, `EVA`, `IFI`, `INT`, `IFT`, `TTC`, `REF`, `OFS`, `HIR`, `REJ`.

**Outputs**: Response.

- `data` (object): The response returned by the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Pass to the continuation input to read the next page.

**Example output**

```json
{
  "data": {
    "id": 1,
    "reminder_sent": false,
    "stage": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Delete candidate invitation

Delete candidate invitation.

**Inputs**

- Candidature id (`candidature_id`, text, required): The invitation ID, not the candidate test-taker ID.

**Outputs**: Response.

- `data` (object): The response returned by the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Pass to the continuation input to read the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Get assessment

Get assessment.

**Inputs**

- Assessment (`assessment_id`, text, required): Pick an assessment or use its ID from an earlier step.

**Outputs**: Response.

- `data` (object): The response returned by the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Pass to the continuation input to read the next page.

**Example output**

```json
{
  "data": {
    "id": 1,
    "name": "example",
    "public_links": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get candidate

Get candidate.

**Inputs**

- Test taker id (`test_taker_id`, text, required): The testtaker_id from an invitation or list of candidates.
- Candidature id (`candidature_id`, text): Candidature id to use.

**Outputs**: Response.

- `data` (object): The response returned by the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Pass to the continuation input to read the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Get personality interpretation

Get personality interpretation.

**Inputs**

- Algorithm (`algorithm`, text, required): Algorithm to use. One of: `enneagram`, `disc`, `16_types`, `big_5`, `culture_fit`.
- Score (`score`, text, required): Score to use.

**Outputs**: Response.

- `data` (object): The response returned by the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Pass to the continuation input to read the next page.

**Example output**

```json
{
  "data": {
    "personality": "example"
  },
  "has_more": false,
  "next_cursor": null
}
```

### Get test result

Get test result.

**Inputs**

- Result id (`result_id`, text, required): Result id to use.

**Outputs**: Response.

- `data` (object): The response returned by the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Pass to the continuation input to read the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Invite candidate

Invite candidate.

**Inputs**

- Assessment (`assessment_id`, text, required): Pick an assessment or use its ID from an earlier step.
- Email (`email`, text, required): Email to use.
- First name (`first_name`, text, required): First name to use.
- Last name (`last_name`, text, required): Last name to use.
- No email (`no_email`, true/false): No email to use.

**Outputs**: Response.

- `data` (object): The response returned by the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Pass to the continuation input to read the next page.

**Example output**

```json
{
  "data": {
    "assessment": 1,
    "email": "example",
    "first_name": "example",
    "id": 1,
    "invitation_uuid": "example",
    "last_name": "example",
    "status": "example",
    "testtaker_id": 1
  },
  "has_more": false,
  "next_cursor": null
}
```

### List assessments

List assessments.

**Inputs**

- Status (`status`, list): Status to use. One or more of: `new`, `active`, `archived`.
- Ordering (`ordering`, text): Ordering to use. One of: `modified`, `-modified`, `name`, `-name`, `candidates`, `-candidates`, `finished_percentage`, `-finished_percentage`.
- Limit (`limit`, number): Limit to use. At least 1.
- Offset (`offset`, number): Offset to use. At least 0.

**Outputs**: Response.

- `data` (object): The response returned by the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Pass to the continuation input to read the next page.

**Example output**

```json
{
  "data": {
    "count": 0,
    "results": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### List candidates in an assessment

List candidates in an assessment.

**Inputs**

- Assessment (`assessment_id`, text, required): Assessment id to use.
- Status (`status`, text): Status to use. One of: `invited`, `started`, `completed`.
- Stage (`stage`, text): Stage to use. One of: `NYE`, `EVA`, `IFI`, `INT`, `IFT`, `TTC`, `REF`, `OFS`, `HIR`, `REJ`.
- Limit (`limit`, number): Limit to use. At least 1.
- Offset (`offset`, number): Offset to use. At least 0.

**Outputs**: Response.

- `data` (object): The response returned by the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Pass to the continuation input to read the next page.

**Example output**

```json
{
  "data": {
    "count": 0,
    "results": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### List test results

List test results.

**Inputs**

- Assessment id (`assessment_id`, text, required): Assessment id to use.
- Test taker id (`test_taker_id`, text, required): Test taker id to use.

**Outputs**: Response.

- `data` (object): The response returned by the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Pass to the continuation input to read the next page.

**Example output**

```json
{
  "data": {
    "count": 0,
    "results": []
  },
  "has_more": false,
  "next_cursor": null
}
```

### Send candidate reminder

Send candidate reminder.

**Inputs**

- Candidature id (`candidature_id`, text, required): The invitation ID, not the candidate test-taker ID.

**Outputs**: Response.

- `data` (object): The response returned by the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Pass to the continuation input to read the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Send invitation email

Send invitation email.

**Inputs**

- Candidature id (`candidature_id`, text, required): The invitation ID, not the candidate test-taker ID.

**Outputs**: Response.

- `data` (object): The response returned by the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Pass to the continuation input to read the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```

### Update assessment public link

Update assessment public link.

**Inputs**

- Public link uuid (`public_link_uuid`, text, required): Public link uuid to use.
- Assessment (`assessment_id`, number, required): Assessment id to use. At least 1.
- Active (`active`, true/false): Active to use.
- Label (`label`, text): Label to use.

**Outputs**: Response.

- `data` (object): The response returned by the service.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Pass to the continuation input to read the next page.

**Example output**

```json
{
  "data": {},
  "has_more": false,
  "next_cursor": null
}
```
