MRI Agent Proposals API Documentation

Postman collection → OpenAPI spec →

Introduction

This documentation aims to provide all the information you need to work with our API.

Authenticating requests

To authenticate requests, include an Authorization header with the value "Bearer {TOKEN}".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

Important Authentication Information

All API requests must include the X-Api-Key header with your assigned Partner API key.

For authenticated user requests, first authenticate using the authentication endpoint. Once authenticated, include both:

  • The token returned by the authentication endpoint: Authorization: Bearer <token>
  • The X-Api-Key header

This ensures secure access to the API and proper authentication for user-specific requests.

Endpoints

GET api/v1/healthcheck

GET
https://partners.proposals.agencystudio.com.au
/api/v1/healthcheck

Headers

Content-Type
Example:
application/json
Accept
Example:
application/json
X-Api-Key
Example:
your-api-key
Example request: 
curl --request GET \
    --get "https://partners.proposals.agencystudio.com.au/api/v1/healthcheck" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --header "X-Api-Key: your-api-key"
Example response:
{
    "status": "up"
}

Authenticate with User

POST
https://partners.proposals.agencystudio.com.au
/api/v1/users/auth

Authenticate with the user and get a token to use in future requests

Headers

Content-Type
Example:
application/json
Accept
Example:
application/json
X-Api-Key
Example:
your-api-key

Body Parameters

Example request: 
curl --request POST \
    "https://partners.proposals.agencystudio.com.au/api/v1/users/auth" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --header "X-Api-Key: your-api-key" \
    --data "{
    \"user_id\": 1,
    \"email\": \"test@example.com\"
}"
Example response:
{
    "data": {
        "token": "encrypted string"
    }
}
{
    "message": "User not found"
}

Magic Links

POST
https://partners.proposals.agencystudio.com.au
/api/v1/prospects/magic-link
requires authentication

This endpoint lets you generate a magic link to redirect your user to create a prospect against a property

Headers

Authorization
Example:
Bearer {TOKEN}
Content-Type
Example:
application/json
Accept
Example:
application/json
X-Api-Key
Example:
your-api-key

Body Parameters

Example request: 
curl --request POST \
    "https://partners.proposals.agencystudio.com.au/api/v1/prospects/magic-link" \
    --header "Authorization: Bearer {TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --header "X-Api-Key: your-api-key" \
    --data "{
    \"type\": \"price_update\",
    \"property_id\": 123
}"
Example response:
{
    "data": {
        "magic_link": "string"
    }
}