Apps

List all applications with pagination and filtering

get

Retrieve a paginated list of applications built on Ethos. Supports filtering by app type (APP, INTEGRATION, AGENT) and status (ACTIVE, INACTIVE).

Query parameters

appTypestring · enumOptionalPossible values:

statusstring · enumOptionalPossible values:

limitinteger · max: 50OptionalDefault: 50

offsetnumberOptionalDefault: 0

Responses

200

Successful response

application/json

totalnumberRequired

limitnumberRequired

offsetnumberRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/apps

HTTPcURLJavaScriptPython

GET /api/v2/apps HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "id": 1,
      "name": "text",
      "appType": "APP",
      "authorUserId": 1,
      "link": "https://example.com",
      "description": "text",
      "pictureUrl": "https://example.com",
      "status": "ACTIVE",
      "createdAt": "text",
      "updatedAt": "text",
      "author": {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 1,
        "links": {
          "profile": "https://example.com",
          "scoreBreakdown": "https://example.com"
        },
        "stats": {
          "review": {
            "received": {
              "negative": 1,
              "neutral": 1,
              "positive": 1
            }
          },
          "vouch": {
            "given": {
              "amountWeiTotal": 1,
              "count": 1
            },
            "received": {
              "amountWeiTotal": 1,
              "count": 1
            }
          }
        }
      }
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}

Create a new app

post

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestring · min: 1 · max: 100Required

appTypestring · enumRequiredPossible values:

authorUserIdintegerRequired

linkstring · uriRequired

descriptionstring · min: 1 · max: 1000Required

pictureUrlstring · uriOptional

statusstring · enumOptionalPossible values:

Responses

200

Successful response

application/json

idnumberRequired

namestringRequired

appTypestring · enumRequiredPossible values:

authorUserIdnumberRequired

linkstring · uriRequired

descriptionstringRequired

pictureUrlstring · uriOptional

statusstring · enumRequiredPossible values:

createdAtstringRequired

updatedAtstringRequired

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/apps

HTTPcURLJavaScriptPython

POST /api/v2/apps HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 151

{
  "name": "text",
  "appType": "APP",
  "authorUserId": 1,
  "link": "https://example.com",
  "description": "text",
  "pictureUrl": "https://example.com",
  "status": "ACTIVE"
}

{
  "id": 1,
  "name": "text",
  "appType": "APP",
  "authorUserId": 1,
  "link": "https://example.com",
  "description": "text",
  "pictureUrl": "https://example.com",
  "status": "ACTIVE",
  "createdAt": "text",
  "updatedAt": "text",
  "author": {
    "id": 1,
    "profileId": 1,
    "displayName": "text",
    "username": "text",
    "avatarUrl": "https://example.com",
    "description": "text",
    "score": 1,
    "status": "ACTIVE",
    "userkeys": [
      "text"
    ],
    "xpTotal": 1,
    "xpStreakDays": 1,
    "xpRemovedDueToAbuse": true,
    "influenceFactor": 1,
    "influenceFactorPercentile": 1,
    "humanVerificationStatus": "REQUESTED",
    "validatorNftCount": 1,
    "links": {
      "profile": "https://example.com",
      "scoreBreakdown": "https://example.com"
    },
    "stats": {
      "review": {
        "received": {
          "negative": 1,
          "neutral": 1,
          "positive": 1
        }
      },
      "vouch": {
        "given": {
          "amountWeiTotal": 1,
          "count": 1
        },
        "received": {
          "amountWeiTotal": 1,
          "count": 1
        }
      }
    }
  }
}

Get a specific app by ID

get

Path parameters

idintegerRequired

Responses

200

Successful response

application/json

idnumberRequired

namestringRequired

appTypestring · enumRequiredPossible values:

authorUserIdnumberRequired

linkstring · uriRequired

descriptionstringRequired

pictureUrlstring · uriOptional

statusstring · enumRequiredPossible values:

createdAtstringRequired

updatedAtstringRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/apps/{id}

HTTPcURLJavaScriptPython

GET /api/v2/apps/{id} HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "id": 1,
  "name": "text",
  "appType": "APP",
  "authorUserId": 1,
  "link": "https://example.com",
  "description": "text",
  "pictureUrl": "https://example.com",
  "status": "ACTIVE",
  "createdAt": "text",
  "updatedAt": "text",
  "author": {
    "id": 1,
    "profileId": 1,
    "displayName": "text",
    "username": "text",
    "avatarUrl": "https://example.com",
    "description": "text",
    "score": 1,
    "status": "ACTIVE",
    "userkeys": [
      "text"
    ],
    "xpTotal": 1,
    "xpStreakDays": 1,
    "xpRemovedDueToAbuse": true,
    "influenceFactor": 1,
    "influenceFactorPercentile": 1,
    "humanVerificationStatus": "REQUESTED",
    "validatorNftCount": 1,
    "links": {
      "profile": "https://example.com",
      "scoreBreakdown": "https://example.com"
    },
    "stats": {
      "review": {
        "received": {
          "negative": 1,
          "neutral": 1,
          "positive": 1
        }
      },
      "vouch": {
        "given": {
          "amountWeiTotal": 1,
          "count": 1
        },
        "received": {
          "amountWeiTotal": 1,
          "count": 1
        }
      }
    }
  }
}

Get apps by type

get

Path parameters

appTypestring · enumRequiredPossible values:

Responses

200

Successful response

application/json

idnumberRequired

namestringRequired

appTypestring · enumRequiredPossible values:

authorUserIdnumberRequired

linkstring · uriRequired

descriptionstringRequired

pictureUrlstring · uriOptional

statusstring · enumRequiredPossible values:

createdAtstringRequired

updatedAtstringRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/apps/by-type/{appType}

HTTPcURLJavaScriptPython

GET /api/v2/apps/by-type/{appType} HTTP/1.1
Host: api.ethos.network
Accept: */*

[
  {
    "id": 1,
    "name": "text",
    "appType": "APP",
    "authorUserId": 1,
    "link": "https://example.com",
    "description": "text",
    "pictureUrl": "https://example.com",
    "status": "ACTIVE",
    "createdAt": "text",
    "updatedAt": "text",
    "author": {
      "id": 1,
      "profileId": 1,
      "displayName": "text",
      "username": "text",
      "avatarUrl": "https://example.com",
      "description": "text",
      "score": 1,
      "status": "ACTIVE",
      "userkeys": [
        "text"
      ],
      "xpTotal": 1,
      "xpStreakDays": 1,
      "xpRemovedDueToAbuse": true,
      "influenceFactor": 1,
      "influenceFactorPercentile": 1,
      "humanVerificationStatus": "REQUESTED",
      "validatorNftCount": 1,
      "links": {
        "profile": "https://example.com",
        "scoreBreakdown": "https://example.com"
      },
      "stats": {
        "review": {
          "received": {
            "negative": 1,
            "neutral": 1,
            "positive": 1
          }
        },
        "vouch": {
          "given": {
            "amountWeiTotal": 1,
            "count": 1
          },
          "received": {
            "amountWeiTotal": 1,
            "count": 1
          }
        }
      }
    }
  }
]

Update an existing app

put

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

appIdintegerRequired

Body

application/json

namestring · min: 1 · max: 100Optional

appTypestring · enumOptionalPossible values:

authorUserIdintegerOptional

linkstring · uriOptional

descriptionstring · min: 1 · max: 1000Optional

pictureUrlstring · uriOptional

statusstring · enumOptionalPossible values:

Responses

200

Successful response

application/json

idnumberRequired

namestringRequired

appTypestring · enumRequiredPossible values:

authorUserIdnumberRequired

linkstring · uriRequired

descriptionstringRequired

pictureUrlstring · uriOptional

statusstring · enumRequiredPossible values:

createdAtstringRequired

updatedAtstringRequired

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

404

Not found

application/json

500

Internal server error

application/json

put

/apps/{appId}

HTTPcURLJavaScriptPython

PUT /api/v2/apps/{appId} HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 151

{
  "name": "text",
  "appType": "APP",
  "authorUserId": 1,
  "link": "https://example.com",
  "description": "text",
  "pictureUrl": "https://example.com",
  "status": "ACTIVE"
}

{
  "id": 1,
  "name": "text",
  "appType": "APP",
  "authorUserId": 1,
  "link": "https://example.com",
  "description": "text",
  "pictureUrl": "https://example.com",
  "status": "ACTIVE",
  "createdAt": "text",
  "updatedAt": "text",
  "author": {
    "id": 1,
    "profileId": 1,
    "displayName": "text",
    "username": "text",
    "avatarUrl": "https://example.com",
    "description": "text",
    "score": 1,
    "status": "ACTIVE",
    "userkeys": [
      "text"
    ],
    "xpTotal": 1,
    "xpStreakDays": 1,
    "xpRemovedDueToAbuse": true,
    "influenceFactor": 1,
    "influenceFactorPercentile": 1,
    "humanVerificationStatus": "REQUESTED",
    "validatorNftCount": 1,
    "links": {
      "profile": "https://example.com",
      "scoreBreakdown": "https://example.com"
    },
    "stats": {
      "review": {
        "received": {
          "negative": 1,
          "neutral": 1,
          "positive": 1
        }
      },
      "vouch": {
        "given": {
          "amountWeiTotal": 1,
          "count": 1
        },
        "received": {
          "amountWeiTotal": 1,
          "count": 1
        }
      }
    }
  }
}

Delete an app

delete

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

appIdintegerRequired

Responses

200

Successful response

application/json

idnumberRequired

namestringRequired

appTypestring · enumRequiredPossible values:

authorUserIdnumberRequired

linkstring · uriRequired

descriptionstringRequired

pictureUrlstring · uriOptional

statusstring · enumRequiredPossible values:

createdAtstringRequired

updatedAtstringRequired

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

404

Not found

application/json

500

Internal server error

application/json

delete

/apps/{appId}

HTTPcURLJavaScriptPython

DELETE /api/v2/apps/{appId} HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": 1,
  "name": "text",
  "appType": "APP",
  "authorUserId": 1,
  "link": "https://example.com",
  "description": "text",
  "pictureUrl": "https://example.com",
  "status": "ACTIVE",
  "createdAt": "text",
  "updatedAt": "text",
  "author": {
    "id": 1,
    "profileId": 1,
    "displayName": "text",
    "username": "text",
    "avatarUrl": "https://example.com",
    "description": "text",
    "score": 1,
    "status": "ACTIVE",
    "userkeys": [
      "text"
    ],
    "xpTotal": 1,
    "xpStreakDays": 1,
    "xpRemovedDueToAbuse": true,
    "influenceFactor": 1,
    "influenceFactorPercentile": 1,
    "humanVerificationStatus": "REQUESTED",
    "validatorNftCount": 1,
    "links": {
      "profile": "https://example.com",
      "scoreBreakdown": "https://example.com"
    },
    "stats": {
      "review": {
        "received": {
          "negative": 1,
          "neutral": 1,
          "positive": 1
        }
      },
      "vouch": {
        "given": {
          "amountWeiTotal": 1,
          "count": 1
        },
        "received": {
          "amountWeiTotal": 1,
          "count": 1
        }
      }
    }
  }
}