MOCO icon

MOCO

Consume MOCO API
Join our community

Actions90

Overview

This node operation lists projects from the MOCO API. It allows users to retrieve multiple project entities with various filtering and sorting options. This is useful for scenarios where you need to fetch project data for reporting, analysis, or integration with other systems. For example, you can list all projects updated after a certain date, filter projects by leader or company, or limit the number of results returned.

Use Case Examples

  1. List all projects updated after a specific timestamp.
  2. Fetch projects filtered by leader ID and include archived projects.
  3. Retrieve a limited number of projects with specific tags and sorted by a chosen field.

Properties

Name Meaning
Return All Whether to return all results or only up to a given limit.
Limit Maximum number of project results to return when 'Return All' is false.
IDs Filter projects by specific IDs, comma-separated.
Updated After Filter projects that were created or updated after this timestamp.
Additional Fields Additional optional filters and parameters for listing projects, such as company ID, date ranges, tags, and sorting options.

Output

JSON

  • id - Unique identifier of the project.
  • name - Name of the project.
  • currency - Currency used in the project.
  • start_date - Project start date.
  • finish_date - Project finish date.
  • fixed_price - Fixed price of the project, if applicable.
  • retainer - Boolean indicating if the project is a retainer.
  • leader_id - ID of the project leader.
  • customer_id - ID of the customer associated with the project.
  • budget_monthly - Monthly budget for the project.
  • identifier - Project identifier.
  • company - Complete company details if 'Include Company' is true; otherwise, just ID and name.
  • tags - Tags associated with the project.
  • project_group_id - ID of the project group.
  • updated_at - Timestamp of the last update to the project.

Dependencies

  • MOCO API
  • API authentication token or API key credential

Troubleshooting

  • Ensure the API credentials are correctly configured to avoid authentication errors.
  • If filtering by IDs or other parameters, verify the format and existence of those IDs to prevent empty results.
  • Be aware of API rate limits which might affect large data retrieval when 'Return All' is enabled.
  • Common error messages include invalid parameter errors if unsupported filters or incorrect data types are used; verify input parameters accordingly.

Links

Discussion