---
title: "Grants a customer viewer or editor access to a job by their email."
method: POST
path: "/job/{jobId}/shares"
tags: ["Job"]
---

# Grants a customer viewer or editor access to a job by their email.

`POST /job/{jobId}/shares`

## Request

- Base URL: `https://api.rapidata.ai`
- URL: `https://api.rapidata.ai/job/{jobId}/shares`
- Auth: OpenID Connect (`https://auth.rapidata.ai/.well-known/openid-configuration`, scopes: `openid`, `profile`, `email`, `offline_access`, `api`)

Granting editor access implies viewing. Re-sharing at the same level is idempotent.
 An email with no matching account is accepted and grants nothing; the response does not
 distinguish it from a successful share, so callers cannot probe which emails have accounts.

## Path parameters

- `jobId` string, required

## Request body

- CreateJobShareEndpointInput
  - `email` string, required: The email of the account to share the job with.
  - `level` 'Viewer' | 'Editor', required

## Response `204`

No Content

## Other responses

- `400`: Bad Request
- `401`: Unauthenticated
- `403`: Forbidden

## Changes

- **2026-09-04** `9da534659e5f`: 1 info
  - the security scope `api` was added to the endpoint's security scheme `OpenIdConnect`
- **2026-08-27** `4ee3e6f5e4f4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rapidata/apis/rapidata-api/changes/job/:jobId/shares/post.md)

---

[API](https://skmtc.dev/rapidata/apis/rapidata-api.md) - [All operations](https://skmtc.dev/rapidata/apis/rapidata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rapidata/apis/rapidata-api/revisions/004a977d7d9f?raw)