# Consent Contracts

Learn about Consent Contracts: the formal agreements created by organizations that define precisely what data can be shared or what actions can be performed. Explore their structure, common fields, and how they are managed throughout their lifecycle.

### Contract Structure

Contracts define what data a profile can read from or write to another profile. They have a structured format with read and write permissions.

```mermaid
graph TD
    Contract["ConsentFlowContract"] -->|has| ReadPerms["read: {...}"]
    Contract -->|has| WritePerms["write: {...}"]

    ReadPerms -->|includes| ReadPersonal["personal: {...}"]
    ReadPerms -->|includes| ReadCredentials["credentials: {...}"]

    WritePerms -->|includes| WritePersonal["personal: {...}"]
    WritePerms -->|includes| WriteCredentials["credentials: {...}"]

    ReadPersonal -->|has fields like| NameField["name: {required: boolean}"]

    ReadCredentials -->|has| ReadCategories["categories: {...}"]
    WriteCredentials -->|has| WriteCategories["categories: {...}"]

    ReadCategories -->|has categories like| AchievementCat["Achievement: {required: boolean}"]
    WriteCategories -->|has categories like| IDCat["ID: {required: boolean}"]
```

A minimal contract example:

```json
{
  read: {
    personal: { name: { required: false } },
    credentials: {
      categories: {},
    },
  },
  write: {
    personal: {},
    credentials: {
      categories: {},
    },
  }
}
```

Contracts can also include:

* **Name** - A human-readable name for the contract
* **Description** - Explains the purpose of the contract
* **Reason for Accessing** - Why the contract owner needs this data
* **Needs Guardian Consent** - Flag for contracts involving minors
* **Redirect URL** - Where to direct users after consent
* **Front Door Boost URI** - A credential to display
* **Image** - Visual representation of the contract
* **Auto-Boosts** - Credentials to auto-issue upon consent

### Creating a Contract <a href="#creating-a-contract" id="creating-a-contract"></a>

Contracts are created using the `createConsentFlowContract` endpoint, which is implemented as a profile route requiring authentication with the `contracts:write` scope.

```mermaid
sequenceDiagram
    participant Profile as Profile Owner
    participant API as LearnCloud Network API
    participant DB as Neo4j Database

    Profile->>API: createConsentFlowContract
    Note right of Profile: Contract definition, name, metadata
    API->>DB: Create contract node
    API->>DB: Create relationship to profile

    alt Has Auto-Boosts
        API->>DB: Create auto-boost relationships
    end

    API-->>Profile: Return contract URI
```

\
When creating a contract with auto-boosts, each boost must specify:

* A boost URI pointing to an existing boost credential
* A signing authority configuration (endpoint and name)

The contract creator must have permission to issue the boosts specified in auto-boosts.

### Managing Contracts <a href="#managing-contracts" id="managing-contracts"></a>

Contracts can be:

* **Retrieved** using `getConsentFlowContract` (single contract) or `getConsentFlowContracts` (paginated list)
* **Deleted** using `deleteConsentFlowContract` (if you're the owner)

When a contract is deleted, all consented terms for that contract are also removed.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.learncard.com/core-concepts/consent-and-permissions/consent-contracts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.