# Luminance Matters API

**Canonical:** https://apis.io/apis/luminance/luminance-matters-api/  
**Provider:** Luminance — https://apis.io/providers/luminance/  
**Base URL:** https://your-instance.app.luminance.com/api2  
**Documentation:** https://api.luminance.com/swagger-docsv150

Luminance Matters API is one of 21 APIs that [Luminance](https://apis.io/providers/luminance/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Matters. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

The Matters API from Luminance — 22 operation(s) for matters.

## Operations (41)

| Method | Path | Summary |
|---|---|---|
| GET | `/projects/{project-id}/matters` | Get the matter objects in a particular project |
| POST | `/projects/{project-id}/matters` | Create a New Matter |
| PATCH | `/projects/{project-id}/matters` | Patch information on Matter objects |
| GET | `/projects/{project-id}/matters/{matter-id}` | Get the matter object with a particular matterId in a particular project |
| PATCH | `/projects/{project-id}/matters/{matter-id}` | Patch information on a single Matter object |
| POST | `/projects/{project-id}/matters/create` | Create a New Matter with required matter tags and/or optional matter tags configured for the project. These can be mandatory if configured for the project. |
| GET | `/projects/{project-id}/matters/{matter-id}/versions` | Get the matter versions for a matter in a particular project including a record of current and previous drafts and current attachments to the matter |
| GET | `/projects/{project-id}/matters/{matter-id}/versions/{matter-version-id}/assignable_users` | Gets a list of user names and IDs which can be assigned to a matter version |
| PATCH | `/projects/{project-id}/matters/{matter-id}/versions/{matter-version-id}/assign` | Assigns an available user to the matter version |
| POST | `/projects/{project-id}/matters/{matter-id}/versions/add_attachment` | Creates a new matter version of type attachment to a matter containing the specified document ID |
| GET | `/projects/{project-id}/matters/{matter-id}/annotations` | Get an array of JSON object Annotations added to a matter |
| POST | `/projects/{project-id}/matters/{matter-id}/annotations` | Create an annotation on a matter |
| PATCH | `/projects/{project-id}/matters/{matter-id}/annotations` | Patch the content of multiple matter annotations to a different value |
| GET | `/projects/{project-id}/matters/{matter-id}/annotations/{annotation-id}` | Get an array of JSON object Annotations added to a matter |
| PATCH | `/projects/{project-id}/matters/{matter-id}/annotations/{annotation-id}` | Patch the content of a particular matter annotation to a different value |
| GET | `/projects/{project-id}/matters/{matter-id}/relations` | Get the matter all the matters a matter is related to |
| GET | `/api2/projects/{project_id}/matters` | List matters |
| POST | `/api2/projects/{project_id}/matters` | Create matter (alternate to matters/create) |
| PATCH | `/api2/projects/{project_id}/matters` | Update matters by filter |
| DELETE | `/api2/projects/{project_id}/matters` | Delete matters by filter |
| POST | `/api2/projects/{project_id}/matters/create` | Create matter (and optional annotations and version) |
| GET | `/api2/projects/{project_id}/matters/{matter_id}` | Get matter |
| PATCH | `/api2/projects/{project_id}/matters/{matter_id}` | Update matter |
| DELETE | `/api2/projects/{project_id}/matters/{matter_id}` | Delete matter |
| GET | `/api2/projects/{project_id}/matters/{matter_id}/annotations` | List matter annotations |
| POST | `/api2/projects/{project_id}/matters/{matter_id}/annotations` | Create matter annotation |
| PATCH | `/api2/projects/{project_id}/matters/{matter_id}/annotations` | Update matter annotations by filter |
| DELETE | `/api2/projects/{project_id}/matters/{matter_id}/annotations` | Delete matter annotations by filter |
| GET | `/api2/projects/{project_id}/matters/{matter_id}/annotations/{annotation_id}` | Get matter annotation |
| PATCH | `/api2/projects/{project_id}/matters/{matter_id}/annotations/{annotation_id}` | Update matter annotation |
| DELETE | `/api2/projects/{project_id}/matters/{matter_id}/annotations/{annotation_id}` | Delete matter annotation |
| GET | `/api2/projects/{project_id}/matters/{matter_id}/relations` | List matter relations |
| POST | `/api2/projects/{project_id}/matters/{matter_id}/relations` | Create relation |
| DELETE | `/api2/projects/{project_id}/matters/{matter_id}/relations` | Delete relations by filter |
| GET | `/api2/projects/{project_id}/matters/{matter_id}/relations/{relation_id}` | Get relation |
| DELETE | `/api2/projects/{project_id}/matters/{matter_id}/relations/{relation_id}` | Delete relation |
| GET | `/api2/projects/{project_id}/matters/{matter_id}/events` | List matter events |
| GET | `/api2/projects/{project_id}/matters/{matter_id}/versions` | List matter versions |
| GET | `/api2/projects/{project_id}/matters/{matter_id}/versions/{version_id}/assignable_users` | List assignable users for version |
| PATCH | `/api2/projects/{project_id}/matters/{matter_id}/versions/{version_id}/assign` | Assign a version to a user |
| POST | `/api2/projects/{project_id}/matters/{matter_id}/versions/add_attachment` | Add a document as attachment to matter |

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/luminance/refs/heads/main/openapi/luminance-matters-api-openapi.yml
- **Documentation** — https://api.luminance.com/swagger-docsv150
- **Documentation** — https://api.luminance.com/swagger-docsv140
- **Documentation** — https://api.luminance.com/swagger-docsv130

## Other Luminance APIs (12)

- [Luminance Accounts API](https://apis.io/apis/luminance/luminance-accounts-api/)
- [Luminance Annotation Source Relations API](https://apis.io/apis/luminance/luminance-annotation-source-relations-api/)
- [Luminance Annotation Sources API](https://apis.io/apis/luminance/luminance-annotation-sources-api/)
- [Luminance Annotation Types API](https://apis.io/apis/luminance/luminance-annotation-types-api/)
- [Luminance Annotations API](https://apis.io/apis/luminance/luminance-annotations-api/)
- [Luminance Contract Creation API](https://apis.io/apis/luminance/luminance-contract-creation-api/)
- [Luminance Document Templates API](https://apis.io/apis/luminance/luminance-document-templates-api/)
- [Luminance Documents API](https://apis.io/apis/luminance/luminance-documents-api/)
- [Luminance Folders API](https://apis.io/apis/luminance/luminance-folders-api/)
- [Luminance Matter Versions API](https://apis.io/apis/luminance/luminance-matter-versions-api/)
- [Luminance Project Users API](https://apis.io/apis/luminance/luminance-project-users-api/)
- [Luminance Projects API](https://apis.io/apis/luminance/luminance-projects-api/)

## Tags

Matters

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/luminance/luminance-matters-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/luminance/.